Scrape Creators icon

Scrape Creators

Get real time social media data

Facebook Ad Library → Search Ads

AI-generated

Summary

Search for Facebook ads matching a specified query string with optional filters such as ad type, country, date range, and status, returning up to a specified limit of results.

Inputs

  • Query (required) — The query string to search for in Facebook ads.
  • Additional Fields — Optional filters including Ad Type (All or Political and Issue Ads), Country (2 letter country code, default 'US'), Start Date, End Date (both in YYYY-MM-DD format), Search Type (Keyword Unordered or Exact Phrase), and Status (All, Active, or Inactive).
  • Limit (required) — Maximum number of ads to return in the response.

Output shape

a list of Facebook ads matching the query and filters

The results are paginated internally to fetch up to the specified limit, combining multiple API calls if necessary. Returned data is trimmed to the requested limit and includes only relevant ads based on filter criteria.

Links

Discussion