Search Meta ads by keyword (v1)
Searches the public Meta Ad Library (Facebook and Instagram ads) for required q. Filter by country, delivery status, ad type, media type, dates, language, platform, advertiser page, and reach. Use cursor to page; page_size is 1-10.
Authorization
ApiKeyAuth In: header
Query Parameters
Search keyword, phrase, advertiser name, or numeric ad ID.
1 <= lengthISO 3166-1 alpha-2 country code, or ALL for every country. Defaults to ALL. Examples: US, GB, IN, ALL.
^(?:[a-z]{2}|all)$/iAd delivery status. all = active and inactive ads, active = currently running ads, inactive = stopped ads.
Value in
- "all"
- "active"
- "inactive"
Ad category. ALL includes all ad types; other values narrow results to the selected category.
Value in
- "ALL"
- "POLITICAL_AND_ISSUE_ADS"
- "HOUSING_ADS"
- "EMPLOYMENT_ADS"
- "CREDIT_ADS"
Query match mode. keyword_unordered matches all words in any order; keyword_exact_phrase matches the exact phrase.
Value in
- "keyword_unordered"
- "keyword_exact_phrase"
Creative format filter. all = every format, image = static images, video = videos, meme = image/text meme-style creatives.
Value in
- "all"
- "image"
- "video"
- "meme"
Sort by total impressions.
Value in
- "total_impressions"
Sort direction. Use with sort_mode.
Value in
- "desc"
Pass pageInfo.cursor from the previous response to get the next page. Omit for the first page.
Ads per request, 1-10 (Meta's own page size). Larger values are treated as 10. Use cursor for more.
1 <= value <= 10Start Date in YYYY-MM-DD format.
^\d{4}-\d{2}-\d{2}$End Date in YYYY-MM-DD format.
^\d{4}-\d{2}-\d{2}$Comma-separated ISO 639-1 language codes, for example en,hi.
Comma-separated platforms. Accepted values: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER.
Comma-separated page IDs to limit results to selected advertisers.
^\s*\d+(\s*,\s*\d+)*\s*,?\s*$When true, only return ads targeted to the selected country.
Minimum estimated audience size.
0 <= valueMaximum estimated audience size.
0 <= valuecurl -X GET "https://example.com/v1/meta/search?q=flipkart" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "items": [ { "ad_archive_id": "string", "page_id": "string", "property1": null, "property2": null } ], "pageInfo": { "cursor": "string", "hasNextPage": true } }, "details": { "reason": "no_results", "message": "string" }}