Facebook

Search Facebook Ad Library ads

Search Facebook Ad Library ads by keyword and filters.

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

Request

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

Query parameters

querystring required

Search query text for Facebook Ad Library ads.

sortBy'impressions' | 'most-recent'

Optional sort order for returned ads.

searchType'keyword-unordered' | 'exact-phrase'

Optional keyword matching mode for the search query.

adType'all' | 'political-and-issue'

Optional filter for all ads or political and issue ads.

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.

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.

trimboolean

When true, returns a smaller response with fewer fields.

Response

Facebook Ad Library ads matching the requested search.

Changes

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