Facebook Ad Library search ads

Searches the Meta Ad Library by keyword and returns matching ads. Needs query. Served by ScrapeCreators.

Inputs

1 required

Query: Keyword to search forRequired · query
Sort by: Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped) (total_impressions or relevancy_monthly_grouped)Optional · sort_by
Search type: If you want to search by exact phrase or not (keyword_unordered or keyword_exact_phrase)Optional · search_type
Ad type: Search for all ads or only political and issue ads (all or political_and_issue_ads)Optional · ad_type
Country: This can only be one countryOptional · country
Language: Language to filter ads onOptional · language
Status: Status of the ad (ALL, ACTIVE or INACTIVE)Optional · status
Media type: Media type of the ad (ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME or NONE)Optional · media_type
Start date: Impressions start dateOptional · start_date
End date: Impressions end dateOptional · end_date
Cursor: Cursor to paginate through resultsOptional · cursor
Trim: Set to true for a trimmed down version of the responseOptional · trim

Price: Usage based, at the cost the provider reports for the call
Billing: Billed at the cost the provider reports for the call, never above $0.00188. Your agent sees the maximum before running.
Price checked: 5 October 2026

Your agent reads the schema and the price with inspect_tool before it runs the tool.

Meta Ad Library