Meta Ads Library

Search ads

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.

get/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

Query parameters

querystring required

Keyword or advertiser name.

search_type'keyword_unordered' | 'keyword_exact_phrase'

keyword_unordered (default) or keyword_exact_phrase.

ad_type'all' | 'political_and_issue_ads'

all (default) or political_and_issue_ads.

countrystring

Two uppercase letters or ALL. Defaults to ALL.

status'ALL' | 'ACTIVE' | 'INACTIVE'

Query filter: ACTIVE (default), INACTIVE or ALL. Response: success, partial, failed or challenged.

media_type'ALL' | 'IMAGE' | 'VIDEO' | 'MEME' | 'IMAGE_AND_MEME' | 'NONE'

ALL (default), IMAGE, VIDEO, MEME, IMAGE_AND_MEME or NONE.

sort_by'total_impressions' | 'relevancy_monthly_grouped'

total_impressions (default) or relevancy_monthly_grouped.

languagestring

Optional two-letter content language.

start_datestring

Optional real calendar date YYYY-MM-DD.

end_datestring

Optional real calendar date YYYY-MM-DD, on or after start_date.

trim'true' | 'false'

Use the compact field projection while preserving creative snapshots and regional transparency.

cursorstring

Opaque continuation token bound to the operation and filters. POST supports long cursor values.

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.