# Google Ads API — UnifAPI

> Ads Transparency Center: advertisers and ads. Search Google Ads Transparency Center advertisers, list the ads an advertiser runs, and read one ad's formats, regions and dates.

- Category: Ad libraries
- API base URL: https://api.unifapi.com
- Auth: `Authorization: Bearer <UnifAPI API key>` (OAuth recommended for MCP clients)
- MCP server: https://mcp.unifapi.com
- Developer docs: https://docs.unifapi.com/api/google-ads
- OpenAPI spec: https://unifapi.com/openapi.json
- HTML page: https://unifapi.com/apis/google-ads
- Full catalog: https://unifapi.com/apis.md

## Agent workflows

- 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.

## Endpoints (3)

Every endpoint returns the UnifAPI JSON envelope (`request_id`, `data`, `pagination` on lists, `billing`) and bills max(records × credits per record, minimum) in credits.

### Get a Google ad by Transparency Center URL

`GET /google-ads/ads`

Returns one creative from the Google Ads Transparency Center by its public URL: advertiser, format, regions, run dates and creative assets. Returns `not_found` when the creative does not exist.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `url` (query)
- Details: https://unifapi.com/apis/google-ads/ads/get
- Docs: https://docs.unifapi.com/api/google-ads/ads/get

### List ads an advertiser runs on Google

`GET /google-ads/advertisers/{id}/ads`

Returns ads from the Google Ads Transparency Center for one advertiser id, with region, platform, format, topic and date filters. Find advertiser ids with /google-ads/advertisers/search. Paginate with `cursor`.

- Price: 1 credit per record, minimum 75 credits ($0.07) per call
- Required: `id` (path)
- Details: https://unifapi.com/apis/google-ads/advertisers/id/ads/get
- Docs: https://docs.unifapi.com/api/google-ads/advertisers/id/ads/get

### Search Google Ads Transparency advertisers

`GET /google-ads/advertisers/search`

Returns Google Ads Transparency Center advertisers and websites that match a name, with advertiser ids for /google-ads/advertisers/{id}/ads.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `query` (query)
- Details: https://unifapi.com/apis/google-ads/advertisers/search/get
- Docs: https://docs.unifapi.com/api/google-ads/advertisers/search/get

## Related APIs

- [SEO API](https://unifapi.com/apis/seo/index.md) — Keyword volume, SERP checks, backlinks, domain rank
- [Facebook API](https://unifapi.com/apis/facebook/index.md) — Pages, posts, reels, groups, events, Marketplace, Ad Library
- [LinkedIn API](https://unifapi.com/apis/linkedin/index.md) — People, companies, posts, jobs, ads, search