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: 15 — or 45 with fuzzy=true. An empty result is not billed.
Google’s own matching has no typo tolerance: advertiser names match by word prefix (ruff wear finds Ruff Wear, Inc., ruffwear does not) and domains by substring (uffwear finds ruffwear.com). A single typo — rufwear, ruffwearp — returns nothing. Set fuzzy=true to find misspelled and look-alike advertisers.

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
required
Advertiser name or domain to autocomplete. Minimum 2 characters.
string
default:"US"
Echoed on the response only. Use country to filter advertisers.
integer
default:"10"
Advertisers to return, 1–3000. 3000 is Google’s own per-call ceiling; one call returns every match up to it, so advertisers do not page.
integer
default:"10"
Domain rows to return, 0–100. They follow the advertiser rows.
string
ISO 3166-1 alpha-2. Only advertisers registered in this country. Domain rows are not filtered.
string
next_page_token from a previous response: the next page of domain rows. Cannot be combined with fuzzy.
boolean
default:"false"
Find misspelled and look-alike advertisers. Searches up to 7 variants of the query (shorter prefixes, overlapping halves, swapped leading letters), resolves the closest look-alike domains to the advertisers running ads on them, drops weak matches, and ranks every row by similarity. Billed 45 credits (3 lookups), however many variants run.

Response

string
Echo of the requested text.
string
string
The applied country filter, upper-cased, or null.
boolean
string[]
fuzzy=true only: the query variants that were searched.
string[]
fuzzy=true only: variants whose upstream call failed. The rest are still returned.
string
Pass as cursor for the next page of domain rows.
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.

Finding look-alike advertisers

fuzzy=true is built for brand protection. Impersonators rarely advertise under the brand’s name. They register under a personal or unrelated name and point ads at a look-alike domain, so no name search reaches them. The fuzzy mode resolves those domains to the advertiser behind them:
The same query without fuzzy returns "advertisers": []. Pass any advertiser_id to /ads/search to see the ads.

Errors