UnifAPI Docs

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. Find advertiser ids with /google-ads/advertisers/search. Paginate with `cursor`.

Pricing — $$$ · min $0.07

Minimum 75 credits ($0.07) per call. Records returned above the minimum bill 1 credit ($0.001) each.

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

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

id*string

Google Ads Transparency advertiser id (AR…).

Length1 <= length <= 500

Query Parameters

topic?string

Optional topic filter. When political, region is required.

Value in

  • "all"
  • "political"
region?string

Optional region filter as a two-letter country code.

Length1 <= length
start_date?string

Optional start date filter in YYYY-MM-DD format.

Length1 <= length
end_date?string

Optional end date filter in YYYY-MM-DD format.

Length1 <= length
platform?string

Optional Google surface filter.

Value in

  • "google_maps"
  • "google_play"
  • "google_search"
  • "google_shopping"
  • "youtube"
format?string

Optional creative format filter.

Value in

  • "text"
  • "image"
  • "video"
cursor?string

Opaque pagination cursor from a previous response's pagination.next_cursor. Omit for the first page.

Length1 <= length <= 16384

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/google-ads/advertisers/string/ads"
{  "request_id": "string",  "data": [    {      "advertiser_id": "string",      "creative_id": "string",      "format": "string",      "ad_url": "string",      "advertiser_name": "string",      "domain": "string",      "image_url": "string",      "first_shown_at": 0,      "last_shown_at": 0,      "overall_impressions": {        "min": 0,        "max": 0      },      "creative_regions": [        {          "region_code": "string",          "region_name": "string"        }      ],      "variations": [        {          "destination_url": "string",          "headline": "string",          "description": "string",          "all_text": "string",          "image_url": "string",          "images": [            "string"          ],          "visible_url": "string",          "youtube_url": "string"        }      ]    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}