Skip to main content
GET
Search Advertisers
Resolve an advertiser name or domain to the advertiser_id the other endpoints take. This is the entry point for brand-name lookups — free-text search on /ads/search is domain-based and will not find a brand by name. Credits: 5

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
required
Advertiser name or domain to autocomplete. Minimum 2 characters.
string
default:"US"
ISO 3166-1 alpha-2 region, or anywhere. Echoed on the response.
integer
default:"10"
Suggestions to return, 120.

Response

string
Echo of the requested text.
string
AdvertiserSuggestion[]

Example

Response
A brand often has one advertiser entity per country. Check the suggestion’s own region before assuming the first hit is the one running ads in the market you care about.

Errors