UnifAPI Docs

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. Returns `not_found` when the creative does not exist.

Pricing — $ · min $0.003

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

GET
/google-ads/ads

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

url*string

Public Google Ad Transparency URL for the creative.

Length1 <= length <= 4096

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/ads?url=string"
{  "request_id": "string",  "data": {    "advertiser_id": "string",    "creative_id": "string",    "url": "string",    "format": "string",    "first_shown_at": 0,    "last_shown_at": 0,    "overall_impressions": {      "min": 0,      "max": 0    },    "creative_regions": [      {        "region_code": "string",        "region_name": "string"      }    ],    "region_stats": [      {        "region_code": "string",        "region_name": "string",        "first_shown_at": 0,        "last_shown_at": 0,        "impressions": {          "min": 0,          "max": 0        },        "platform_impressions": [          {            "platform": "string",            "impressions": {              "min": 0,              "max": 0            }          }        ]      }    ],    "targeting": {      "age": {        "included": [          "string"        ],        "excluded": [          "string"        ]      },      "gender": {        "included": [          "string"        ],        "excluded": [          "string"        ]      },      "location": {        "included": [          {            "criterion_id": "string",            "name": "string",            "full_name": "string",            "country_codes": [              "string"            ]          }        ],        "excluded": [          {            "criterion_id": "string",            "name": "string",            "full_name": "string",            "country_codes": [              "string"            ]          }        ]      }    },    "variations": [      {        "destination_url": "string",        "headline": "string",        "description": "string",        "all_text": "string",        "image_url": "string",        "images": [          "string"        ]      }    ]  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}