Who advertises on a term or domain
ads_advertisers is a $0.20 GET request on the Wuthering AI API. Find the companies running ads for a brand or domain, and how many. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/ads_advertisers
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/ads_advertisers?keyword=…&token=YOUR_TOKEN'
What does ads_advertisers return, and when should you call it?
Find advertisers by brand name or domain and return their verified advertiser records with approximate ad counts.
Search by BRAND NAME or DOMAIN, not by category keyword: a generic category term returns "No Search Results", while a competitor's name or domain returns their advertiser id. Feed that id into wuthering_ads_creatives to see the actual ads.
Returns: advertiser_id, title, domain, verified status, approx_ads_count, location, rank_absolute.
Use as the first step of any competitive ad research. Don't use to see creatives, which is the next tool.
What parameters does ads_advertisers take?
ads_advertisers accepts 4 parameters, none of them required. Array values are comma-separated on the query string.
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | string | no | Brand or company name to find advertisers for. Use this or target. |
| target | string | no | Registrable domain to find advertisers for, for example 'acme.com'. |
| location_code | number | no | Numeric location code to scope results to. Defaults to 2840 (United States). Search volume and competition vary sharply by country, so set this when the question is about a specific market.Defaults to 2840 |
| limit | number | no | Maximum rows to return (1 to 120, default 40). Ask for the fewest that answer the question: every row is billed and spends the caller's context.Defaults to 40 |
Which playbooks call ads_advertisers?
5 of the research playbooks name ads_advertisers in their method. Each is free to read and says where in the sequence the call belongs.
- Is there real demand for this?Test an idea against the cheapest evidence that could kill it — search demand, sustained ad spend, posted salaries, and the words buyers use — and return a verdict with the number that decides it.
- Who are we really up against?Work April Dunford's positioning sequence from public evidence: the alternatives a prospect would actually use, what only you do, the value that follows, who cares most, and the category that makes all of it obvious.
- Where do the next 1,000 customers come from?Score every plausible channel against the product's own characteristics, measure the reachable demand and the cost of entry for each, and commit to one with its CAC and its ceiling stated.
- Is this company actually growing?Read one company's trajectory from public evidence: branded demand year over year, the acquisition engine underneath it, whether that demand was earned or bought, and what payroll says ships next — then name the questions only a data room can close.
- What would prove us wrong?Turn a belief the plan depends on into an explanation that cannot be bent to fit any result, name the rival explanations that would produce the same evidence, and pay only for the observations that would come out differently under each.
Reference for ads_advertisers · last updated · published by Wuthering AI