Google Ad Library Advertiser Search API
Turn a brand name into Google Ad Transparency advertiser ids — then pull creatives with the rest of the Google Ad Library tag.
GET /v1/google/ad-library/advertisers/search1 credit per successful request.
About this endpoint
Google's Ad Transparency Center is useful when you already know which advertiser entity to open. Discovery is the hard part: the same brand often has separate advertiser rows per country or legal entity, and clicking through the UI does not scale for scheduled competitor monitoring.
`GET /v1/google/ad-library/advertisers/search` takes a required `query` string (the name you would type into Ad Transparency search) and an optional `region` as a two-letter country code. When `region` is omitted, the lookup defaults to `US`. The response is the shared Social Fetch envelope: `data.query` echoes the search, `data.advertisers` lists matches with `name`, `advertiserId`, `region`, and `adsEstimate`, `data.websites` lists related domains, and `data.totalAdvertisers` is the count in this response. Bill from `meta.creditsCharged`.
This route is advertiser discovery, not a creative dump. Once you have an `advertiserId` (or a domain from `data.websites`), use `GET /v1/google/ad-library/companies/ads` for that advertiser's ads. For one known creative URL, use `GET /v1/google/ad-library/ads`. Pair the Google tag with Facebook Ad Library search when you track the same brand across Meta and Google on one API key.
Google Ad Library Advertiser Search API FAQ
What does Google Ad Library advertiser search return?
Matching advertisers under data.advertisers (name, advertiserId, region, adsEstimate), related website domains under data.websites, the echoed query under data.query, and data.totalAdvertisers for how many advertiser rows came back. Each response uses the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.
How do I search Google Ad Transparency advertisers by name?
Send GET /v1/google/ad-library/advertisers/search with x-api-key and a required query parameter. Optionally pass region as a two-letter country code (for example CA or AU). When region is omitted, the search defaults to US. Full parameter rules are in the API docs.
How much does Google Ad Library advertiser search cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
How is advertiser search different from listing company ads?
Advertiser search finds Google Ad Transparency advertiser entities by name. GET /v1/google/ad-library/companies/ads lists ads for a known domain or advertiserId. Use search first when you only have a brand string; use company ads when you already have an id or domain.
What is advertiserId used for?
advertiserId is the Google Ad Transparency identifier for that advertiser row. Pass it to GET /v1/google/ad-library/companies/ads when you want that entity's ads instead of guessing a domain.
Can I limit the search to one country?
Yes. Pass region as an ISO 3166-1 alpha-2 country code. Omit it to use the default US search region. Region on each returned advertiser row is separate: it describes that entity when Google reports one, and may be null.
Do I need a Google Ads account to search Ad Transparency advertisers?
No. You authenticate to Social Fetch with an API key. The route reads public Ad Transparency-style advertiser search results; it does not act on behalf of an ads account you manage.