Facebook Ad Library API

5 endpoints for public Facebook Ad Library data, from 5 credits a call. Same response format and field names as every other platform.

curl "https://scrapeio.com/v1/facebook/adLibrary/ad" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/ad5 credits

Ad Details

Parameter	Type	Description
`id`	string	Facebook Ad Id
`url`	string	Facebook Ad URL
`get_transcript`	boolean	Transcription is opt-in via gettranscript=true.
`trim`	boolean	Set to true for a trimmed down version of the response
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/facebook/adLibrary/ad" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/ad/transcript5 credits

Ad Transcript

Parameter	Type	Description
`id`	string	Facebook Ad Id
`url`	string	Facebook Ad URL
`cache_max_age`	1d, 3d, 7d, 14d, 30d	If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "ca

curl "https://scrapeio.com/v1/facebook/adLibrary/ad/transcript" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/company/ads5 credits

Company Ads

Parameter	Type	Description
`pageId`	string	The companies ad library page id.
`companyName`	string	The name of the company.
`country`	string	This can only be one country.
`status`	ALL, ACTIVE, INACTIVE	Status of the ad.
`media_type`	ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE	Media type of the ad.
`language`	string	Language to filter ads on.
`sort_by`	total_impressions, relevancy_monthly_grouped	Sort by impressions (high to low), or Most Recent (relevancymonthlygrouped).
`start_date`	string	Start date to search for.
`end_date`	string	End date to search for.
`trim`	boolean	Set to true for a trimmed down version of the response
`cursor`	string	Cursor to paginate through results

curl "https://scrapeio.com/v1/facebook/adLibrary/company/ads" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/search/ads5 credits

Parameter	Type	Description
`query`required	string	Keyword to search for
`sort_by`	total_impressions, relevancy_monthly_grouped	Sort by impressions (high to low), or Most Recent (relevancymonthlygrouped).
`search_type`	keyword_unordered, keyword_exact_phrase	If you want to search by exact phrase or not
`ad_type`	all, political_and_issue_ads	Search for all ads or only political and issue ads
`country`	string	This can only be one country.
`language`	string	Language to filter ads on.
`status`	ALL, ACTIVE, INACTIVE	Status of the ad.
`media_type`	ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE	Media type of the ad.
`start_date`	string	Impressions start date.
`end_date`	string	Impressions end date.
`trim`	boolean	Set to true for a trimmed down version of the response
`cursor`	string	Cursor to paginate through results

curl "https://scrapeio.com/v1/facebook/adLibrary/search/ads?query=coffee" \
  -H "x-api-key: YOUR_KEY"

GET/v1/facebook/adLibrary/search/companies5 credits

Search for Companies

Parameter	Type	Description
`query`required	string	Keyword to search for

curl "https://scrapeio.com/v1/facebook/adLibrary/search/companies?query=coffee" \
  -H "x-api-key: YOUR_KEY"

Other platforms