Facebook Ad Search Autocomplete API

Provide query and country to request country-aware ad-search suggestions. This documented autocomplete route has not been sampled, so suggestion text, advertiser keys, ordering and response shape must be validated. Use suggestions to refine a discovery query, then deliberately run the relevant ad search. Autocomplete is not an advertising-targeting audience, proof of advertiser identity or a complete list of brands in a market.

API Features

Ad-query refinement input Accepts a partial keyword for the documented ad-search suggestion workflow.

Country-scoped suggestion request A country input accompanies the query rather than assuming a universal suggestion list.

Discovery before ad retrieval Suggestions can guide a later explicit search without being treated as ad-detail records.

No targeting-audience semantics Returned suggestions must not be presented as available advertising audiences.

Live API Demo

GET /api/project/facebook-scraper/autocomplete

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/facebook-scraper/autocomplete?key=<API_KEY>&country=US&query=pizza'

curl -X GET 'https://api.opendata-api.com/api/project/facebook-scraper/autocomplete?key=<API_KEY>&country=US&query=pizza'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Evaluate country-aware suggestions while a marketer types a brand query.
Help an analyst disambiguate a partial advertiser name before keyword search.
Compare suggestion responses for the same term in selected country contexts after validation.
Keep suggestion selection separate from the explicit user action that requests advertisement records.

Frequently asked questions

Does autocomplete return complete ads directly?

Do not assume so. It is intended for suggestions and query refinement, and its exact fields still need validation. Deliberately run a separate search for ad records.

Why is country required?

The suggestion request includes country context. Do not assume that suggestions are identical across markets.

Can a suggestion prove advertiser identity or identify a targetable audience?

No. It is only a discovery lead, not identity verification, a complete brand directory or an audience-targeting capability.

Related operations

Guides

View Subscription Plans →

Suggest Ad Search Terms