Search Meta advertisers (v1)
Searches the Meta Ad Library for advertiser pages matching required q. Returns page IDs and verification details to use with the page endpoints. Optional country and ad_type narrow results; raw returns the unprocessed payload.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
q*string
Brand, company, or advertiser page search query.
Length
1 <= lengthcountry?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)$/iad_type?string
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"
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/search-pages?q=flipkart" \ -H "x-api-key: YOUR_API_KEY"{ "data": {}, "details": { "reason": "no_results", "message": "string" }}