Google Ads Transparency API

Google Ads Transparency Center records: search advertisers, list the ads an advertiser runs, and look up a single ad.

When To Use This APICopy Anchor Link

The Google Ads Transparency API is for agent workflows that need public, platform-native data without writing a custom collector for every task. Use it when a prompt needs evidence from live public records, when a Skill needs repeatable enrichment, or when product code needs the same contract an agent discovered through MCP.

This section lists 3 live Google Ads Transparency operations from the canonical OpenAPI spec. Each operation page documents the route, method, parameters, response envelope, pagination behavior when available, and the error vocabulary shared across UnifAPI.

• See which text, image and video ads a competitor runs on Google, with first and last shown dates.
• Find advertisers by name and estimate how many ads each one runs.
• Read an ad's text, images, destination URLs and regional impressions for creative research.

Agent Contract NotesCopy Anchor Link

Agents usually discover these endpoints with the hosted UnifAPI MCP server, inspect the operation schema, then call only the records needed for the current task. Developers can call the same endpoints over HTTP with an API key, which makes the path from exploratory agent run to production integration direct.

Every successful response uses a stable envelope with a request id, data payload, optional pagination cursor, and billing metadata. Errors use the same closed vocabulary across platforms, so retry logic, user-facing explanations, and cost reporting can stay consistent even when a workflow spans multiple public-data sources.

When you are choosing an operation, start from the public identifier the user already has: a profile username, post id, channel id, subreddit name, search term, or URL-derived slug. Prefer the narrowest endpoint that answers the question, then expand only when the agent needs more evidence. This keeps record usage predictable, makes citations easier to explain, and avoids turning a focused research task into an expensive crawl.

OperationsCopy Anchor Link

AdsCopy Anchor Link

• GET /google-ads/ads — Get a Google ad by Transparency Center URL — Returns one creative from the Google Ads Transparency Center by its public URL: advertiser, format, regions, run dates and creative assets.

AdvertisersCopy Anchor Link

• GET /google-ads/advertisers/{id}/ads — List ads an advertiser runs on Google — Returns ads from the Google Ads Transparency Center for one advertiser id, with region, platform, format, topic and date filters.
• GET /google-ads/advertisers/search — Search Google Ads Transparency advertisers — Returns Google Ads Transparency Center advertisers and websites that match a name, with advertiser ids for /google-ads/advertisers/{id}/ads.