Sign inGet a free API key
Menu

APIs / Social media / Facebook Ad Library

1 credit per call4 endpoints

Facebook Ad Library API

Get Facebook Ad Library data as structured JSON with one API key: search, advertisers, eu report and filters. Free credits every month.

Get a free API keyRun it below
Facebook Ad Library
GET/v1/facebook-ad-library/search?query=climate&country=US&ad_type=POLITICAL_AND_ISSUE_ADS
curl "https://api.perceptlayer.com/v1/facebook-ad-library/search?query=climate&country=US&ad_type=POLITICAL_AND_ISSUE_ADS" \
  -H "X-API-Key: $API_KEY"
cURL1 credit per successful call
Run this call below or from your dashboard to see a live response.

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/facebook-ad-library/search?query=climate&country=US&ad_type=POLITICAL_AND_ISSUE_ADS" \
  -H "X-API-Key: $API_KEY"

Facebook Ad Library · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

Note
Endpoints marked “Needs terms” return personal or social data. They work once you accept the restricted-endpoint terms in your dashboard.
EndpointRequired parametersCost
GET/v1/facebook-ad-library/advertisers
query+2 optionalNeeds terms
1 credit
GET/v1/facebook-ad-library/eu-report
section+2 optionalNeeds terms
1 credit
GET/v1/facebook-ad-library/filters
none+3 optionalNeeds terms
1 credit
GET/v1/facebook-ad-library/search
none+9 optionalNeeds terms
1 credit

Overview

What you can get

The Facebook Ad Library API returns search, advertisers, eu report and filters as clean JSON. Each successful call costs one credit, and calls that fail are free.

Social mediaJSONRESTMCPSome endpoints need terms

More social media APIs

BehanceBilibiliBlueskyDailymotionDeviantArtDribbbleFacebookFlickrHacker NewsImgurInstagramKick

Use cases

Research the ads your competitors run

Use the Facebook Ad Library API to research the ads your competitors run

Track advertisers' activity over time

Use the Facebook Ad Library API to track advertisers' activity over time

Pull EU ad transparency reports

Use the Facebook Ad Library API to pull EU ad transparency reports

FAQ

Questions

How much does the Facebook Ad Library API cost?

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Do I need a separate key for Facebook Ad Library?

No. One key works for every API in the catalogue.

Try the Facebook Ad Library API with 1,000 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs