Google Ads Transparencygoogle.advertisers.search

Google Ads Transparency advertiser search API

Find advertisers in the Google Ads Transparency Center by name: advertiser ID, the name Google verified, the country it is registered in and the center's estimate of how many ads it has. The verified name is often the legal entity, not the brand.

GEThttps://api.okdata.online/v1/google/advertisers/search

Price

One call costs $0.004 and returns one page of about 10 advertisers. Collecting 1,000 advertisers takes about 100 calls, $0.40 in total. Each page is a separate call; failed calls are not charged.

Parameters

Name	Type	Description
`query` *required	string	Keywords, as a person would type them into the platform search box. e.g. `Stanley`
`country`	string	Country to search in (ISO code); US by default. e.g. `US`
`cursor`	string	Opaque cursor from page.next_cursor of the previous call. Each page is a separate call.
`view`	stringcompactstandardfull	How much of each object comes back. full adds platform-specific fields under ext. default `standard`
`fields`	string	Comma-separated fields to keep, to save tokens.

cursor, view and fields work the same on every endpoint: how requests work.

Returned fields

Each item is a Advertiser.

Field	Type	Description
`id`	string	Advertiser ID in the library.
`url`	string	The advertiser's page in the library.
`name`	string	The name the library shows, often the legal entity.
`region`	string \| null	Country or region it is registered in (ISO code).
`ads`	integer \| null	The library's estimate of how many ads it has.
`ext`	object	Platform-specific extras. Only returned with view=full.

Request

cURL

curl -G "https://api.okdata.online/v1/google/advertisers/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=Stanley'

Python

import os
import requests

resp = requests.get(
    "https://api.okdata.online/v1/google/advertisers/search",
    headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
    params={"query": "Stanley"},
    timeout=60,
)
body = resp.json()
if body["code"] != "ok":
    raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})")

for row in body["data"]["items"]:
    print(row["id"], row["name"], row["ads"])
print("cost: $" + body["meta"]["billing"]["amount"])

TypeScript

const url = new URL('https://api.okdata.online/v1/google/advertisers/search');
url.searchParams.set('query', "Stanley");

const res = await fetch(url, {
  headers: {
    Authorization: `Bearer ${process.env.OKDATA_API_KEY}`,
  },
});
const body = await res.json();
if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`);

for (const row of body.data.items) {
  console.log(row.id, row.name, row.ads);
}
console.log('cost: $' + body.meta.billing.amount);

MCPtools/call

{
  "name": "call",
  "arguments": {
    "endpoint": "google.advertisers.search",
    "params": {
      "query": "Stanley"
    }
  }
}

Or ask an agent that has the MCP server connectedUse Google Ads Transparency advertiser search and find the advertiser ID of this brand.

Response

200 · application/jsonmeta.billing.amount = 0.004

{
  "code": "ok",
  "request_id": "0f6c2a8e-4b1d-4e0a-9a51-3c7d2b9e1f20",
  "data": {
    "items": [
      {
        "id": "AR17172796163137470465",
        "url": "https://adstransparency.google.com/advertiser/AR17172796163137470465",
        "name": "PACIFIC MARKET INTERNATIONAL, LLC",
        "region": "US",
        "ads": 2000
      }
    ]
  },
  "page": {
    "next_cursor": "eyJvIjoyMH0",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "capability": "google.advertisers.search",
    "billing": {
      "amount": "0.004",
      "currency": "USD",
      "balance_after": "9.996"
    },
    "unavailable": {},
    "cached": false,
    "replayed": false,
    "fetched_at": "2026-11-11T08:00:00Z"
  }
}

Try it

This sends a real call to https://api.okdata.online and is billed as usual: at most $0.004. Failed calls are free. Your key goes only to that address and is never stored on this site.

Questions

How much does the Google Ads Transparency advertiser search API cost?

One call costs $0.004 and returns one page of about 10 advertisers. Collecting 1,000 advertisers takes about 100 calls, $0.40 in total. Each page is a separate call; failed calls are not charged.

How do I get the next page?

Pass page.next_cursor from the response back as the cursor parameter. When page.has_more is false there is nothing left. Every page is its own call at $0.004.

Do I need a Google Ads Transparency account, cookies or a QR login?

No. You send only your okdata API key. The data is public data from Google Ads Transparency; nothing is fetched with your own Google Ads Transparency account.

Am I charged when a call fails?

No. Every error response says charged: false, except a timeout, which says charged: null until the outcome is known. Resend with the same Idempotency-Key and you are never charged twice.

What if Google Ads Transparency does not show a field?

The field is null, and meta.unavailable names it with the reason: platform (the platform never shows it) or capability (we cannot fetch it yet).

Answers that use this endpoint

Google advertiser adsgoogle.advertisers.ads.listAd[]$0.004/call

All Google Ads Transparency endpoints → · Answers