Ad Library Search
Search public Facebook Ad Library ads by keyword.
Ad Library Search
Search public ads by keyword, status, country, media type, and date range.Request Example
results_limit is reached, no next page is available, or the task reaches its pagination safety boundary. Duplicate ad IDs are saved once.
Completed Task Response
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Keyword or phrase used to search public ads.
1Maximum unique ads to save across result pages.
20 <= x <= 2000Sort by estimated impressions or recent relevance.
total_impressions, relevancy_monthly_grouped Match query words in any order or as an exact phrase.
keyword_unordered, keyword_exact_phrase Include all ads or only political and issue ads.
all, political_and_issue_ads ALL or one two-letter country code.
^(ALL|[A-Za-z]{2})$Ad delivery status.
ALL, ACTIVE, INACTIVE Creative media filter.
ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE Impression period start date in YYYY-MM-DD format.
Impression period end date in YYYY-MM-DD format. It cannot precede start_date.
Optional URL that receives the task completion callback.

