Find advertisers by name
Look up advertisers whose registered name matches a brand or company name. Returns the advertiser id the other routes need, the country each advertiser completed its Google verification in, and roughly how many ads it is running as a range. Several distinct advertisers can share a name — a global brand often registers one per market — so compare the ad counts and countries to tell them apart. Matching advertiser websites come back on domains, ready to pass to search-ads as the domain filter.
/search-advertisers Advertisers https://api.fetchlayer.dev/google-ad-library/search-advertisers Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
query string required Advertiser or brand name to look up.
region string optional Two-letter country code, or ANYWHERE. (default: ANYWHERE)
regions string[] optional Several countries at once (max 20).
limit number optional Maximum advertisers returned (max 100), or -1 for everything available. (default: 30)
includeDomains boolean optional Also return advertiser websites matching the name. (default: true)
Response Fields
search-advertisers
Find advertisers by name
advertisers object[] Matching advertisers.
advertisers[].advertiserId string Advertiser id — the handle for advertiser-ads and advertiser-profile.
advertisers[].advertiserName string Registered advertiser name.
advertisers[].countryCode string Country the advertiser is registered in.
advertisers[].approximateAdCount object Ads this advertiser has in the requested country, as a { min, max } range. Google never publishes an exact figure.
advertisers[].adLibraryUrl string Public Ad Library link for the advertiser.
advertiserCount number Number of advertisers in this response.
domains string[] Advertiser websites matching the name, usable as the domain filter on search-ads.
regions string[] The countries the lookup ran against.
notes string[] Caveats about this particular result, such as a list that may be incomplete.
Request
curl -X POST "https://api.fetchlayer.dev/google-ad-library/search-advertisers" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"query":"Nike","region":"US","limit":10}'Response
{
"advertiserCount": 2,
"advertisers": [
{
"advertiserId": "AR01234567890123456789",
"advertiserName": "Nike, Inc.",
"countryCode": "US",
"approximateAdCount": {
"min": 1000,
"max": 5000
}
},
{
"advertiserId": "AR09876543210987654321",
"advertiserName": "Nike Retail B.V.",
"countryCode": "NL",
"approximateAdCount": {
"min": 50,
"max": 100
}
}
],
"domains": [
"nike.com"
],
"notes": []
}