Meta Ads Library

Get company ads

Retrieve public advertiser suggestions or one page of an advertiser’s ads. Company-name lookup requires a unique exact match; use pageId when ambiguous. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/facebook/adLibrary/company/ads

Request

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

Query parameters

pageIdstring

Exact numeric advertiser page ID. Use pageId or companyName.

companyNamestring

Requires exactly one case-insensitive exact advertiser-name match. Prefer pageId to avoid ambiguity.

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.