List Meta ad filter options (v1)
Returns the languages, advertiser pages, and regions that match required query_string in the Meta Ad Library. Optional ad_type, country, and search_type set the context; raw returns the unprocessed payload.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
ad_type?string
Ad category context for filter discovery.
Value in
- "ALL"
- "POLITICAL_AND_ISSUE_ADS"
- "HOUSING_ADS"
- "EMPLOYMENT_ADS"
- "CREDIT_ADS"
country?string
ISO 3166-1 alpha-2 country code, or ALL for every country. Defaults to ALL. Examples: US, GB, IN, ALL.
Match
^(?:[a-z]{2}|all)$/isearch_type?string
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"
query_string*string
Search query used to return context-specific filter options.
Length
1 <= lengthraw?boolean
Set to true to return the unprocessed Ad Library payload instead of the normalized response.
curl -X GET "https://example.com/v1/meta/filter-options?query_string=flipkart" \ -H "x-api-key: YOUR_API_KEY"{ "data": {}, "details": { "reason": "no_results", "message": "string" }}