Meta Ads API: List Meta ad filter options

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. Examples: IN, US, GB, DE.

Length2 <= length <= 2

search_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.

Length1 <= length

raw?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": {}}