Search Advertisers
curl --request GET \
--url https://scrapebadger.com/v1/google/ads/advertisers \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://scrapebadger.com/v1/google/ads/advertisers"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};
fetch('https://scrapebadger.com/v1/google/ads/advertisers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/google/ads/advertisers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/google/ads/advertisers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/google/ads/advertisers")
.header("X-API-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/google/ads/advertisers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"query": "<string>",
"region": "<string>",
"country": "<string>",
"fuzzy": true,
"variants": [
"<string>"
],
"variants_failed": [
"<string>"
],
"next_page_token": "<string>",
"advertisers": [
{
"advertiser_id": "<string>",
"name": "<string>",
"region": "<string>",
"domain": "<string>",
"verified": true,
"ads_count": 123,
"details_link": "<string>",
"similarity": 123,
"matched_query": "<string>"
}
]
}Ads Transparency
Search Advertisers
Resolve an advertiser name or domain to Google Ads Transparency Center advertiser IDs.
GET
/
v1
/
google
/
ads
/
advertisers
Search Advertisers
curl --request GET \
--url https://scrapebadger.com/v1/google/ads/advertisers \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://scrapebadger.com/v1/google/ads/advertisers"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<x-api-key>'}};
fetch('https://scrapebadger.com/v1/google/ads/advertisers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/google/ads/advertisers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/google/ads/advertisers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/google/ads/advertisers")
.header("X-API-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/google/ads/advertisers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"query": "<string>",
"region": "<string>",
"country": "<string>",
"fuzzy": true,
"variants": [
"<string>"
],
"variants_failed": [
"<string>"
],
"next_page_token": "<string>",
"advertisers": [
{
"advertiser_id": "<string>",
"name": "<string>",
"region": "<string>",
"domain": "<string>",
"verified": true,
"ads_count": 123,
"details_link": "<string>",
"similarity": 123,
"matched_query": "<string>"
}
]
}Resolve an advertiser name or domain to the
The same query without
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
Query Parameters
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.ISO 3166-1 alpha-2. Only advertisers registered in this country. Domain rows
are not filtered.
next_page_token from a previous response: the next page of domain rows.
Cannot be combined with fuzzy.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
Show AdvertiserSuggestion
Show AdvertiserSuggestion
Example
curl "https://scrapebadger.com/v1/google/ads/advertisers?query=nike®ion=US&num=10" \
-H "X-API-Key: YOUR_API_KEY"
const res = await fetch(
"https://scrapebadger.com/v1/google/ads/advertisers?" +
new URLSearchParams({ query: "nike", region: "US", num: "10" }),
{ headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const { advertisers } = await res.json();
import requests
res = requests.get(
"https://scrapebadger.com/v1/google/ads/advertisers",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"query": "nike", "region": "US", "num": 10},
)
advertisers = res.json()["advertisers"]
Response
{
"query": "nike",
"region": "US",
"advertisers": [
{
"advertiser_id": "AR01614014350098432001",
"name": "Nike, Inc.",
"region": "US",
"domain": "nike.com",
"verified": true,
"ads_count": 1284,
"details_link": "https://adstransparency.google.com/advertiser/AR01614014350098432001"
},
{
"advertiser_id": "AR08811772660094828545",
"name": "Nike Deutschland GmbH",
"region": "DE",
"domain": "nike.com",
"verified": true,
"ads_count": 402,
"details_link": "https://adstransparency.google.com/advertiser/AR08811772660094828545"
}
]
}
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:
curl "https://scrapebadger.com/v1/google/ads/advertisers?query=rufwear&fuzzy=true" \
-H "X-API-Key: YOUR_API_KEY"
{
"query": "rufwear",
"fuzzy": true,
"variants": ["rufwear", "ruf", "rufw", "fwear", "urfwear", "rfuwear", "ruwfear"],
"variants_failed": [],
"advertisers": [
{
"advertiser_id": "AR01181731973429723137",
"name": "Ruff Wear, Inc.",
"domain": "ruffwear.ca",
"similarity": 0.875,
"matched_query": "ruf"
},
{
"advertiser_id": "AR14220847488281083905",
"name": "葛茂朋",
"domain": "ruffwearcf.shop",
"similarity": 0.814,
"matched_query": "ruffwearcf.shop"
},
{ "advertiser_id": null, "domain": "ruffwear.com", "similarity": 0.875, "matched_query": "ruf" },
{ "advertiser_id": null, "domain": "ruffwearcf.shop", "similarity": 0.814, "matched_query": "fwear" }
]
}
fuzzy returns "advertisers": []. Pass any
advertiser_id to /ads/search
to see the ads.
Errors
| Status | Meaning |
|---|---|
400 | Unknown country, or cursor combined with fuzzy. |
422 | query shorter than 2 characters, or num / num_domains out of range. |
502 | Upstream Transparency Center failure — not billed. |

