Meta Ads Library

Search ads with a POST body

Retrieve one public page with the documented filters and an opaque continuation cursor. Lowercase /adlibrary/ aliases return canonical Post/Author data. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

post/v1/facebook/adLibrary/search/ads

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/facebook/adLibrary/search/ads
  • Auth: API key in header x-api-key

Request body

querystring required
search_type'keyword_unordered' | 'keyword_exact_phrase'
ad_type'all' | 'political_and_issue_ads'
countrystring
status'ALL' | 'ACTIVE' | 'INACTIVE'
media_type'ALL' | 'IMAGE' | 'VIDEO' | 'MEME' | 'IMAGE_AND_MEME' | 'NONE'
sort_by'total_impressions' | 'relevancy_monthly_grouped'
languagestring
start_datestring
end_datestring
trim'true' | 'false'
cursorstring

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.