Facebook

List Facebook company ads

List ads a company or Page is running in the Facebook Ad Library.

get/v1/facebook/ad-library/companies/ads

Request

  • Base URL: https://api.socialfetch.dev
  • URL: https://api.socialfetch.dev/v1/facebook/ad-library/companies/ads
  • Auth: one of:
    • API key in header x-api-key
    • none

Query parameters

pageIdstring

Facebook page id when you have it instead of a company name.

companyNamestring

Company or page name to search when you do not have a page id.

countrystring

Optional country code filter. Use ALL to search all countries.

status'all' | 'active' | 'inactive'

Optional ad status filter.

mediaType'all' | 'image' | 'video' | 'meme' | 'image-and-meme' | 'none'

Optional creative media filter.

languagestring

Optional language code filter.

sortBy'impressions' | 'most-recent'

Optional sort order for returned ads.

startDatestring

Optional start date filter in YYYY-MM-DD format.

endDatestring

Optional end date filter in YYYY-MM-DD format.

cursorstring

Opaque pagination cursor from a previous response.

Response

Ads for the requested company or page.

Changes

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