GoddsAPIFree API key
GoddsAPI Docs

Ads Transparency

The ads an advertiser has run, from Google's Ads Transparency Center: format, first and last shown dates, and a link to each creative.

GET /api/v1/adsCost: 1 per request (0 if cached)

Example request

curl -G "https://goddsapi.com/api/v1/ads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "domain=example.com"

Parameters

NameTypeDefaultDescription
domainrequiredstring—Advertiser domain, e.g. example.com (https:// and www. are stripped).
regionstring—Two-letter region code to filter by.
api_keystring—Your key, if you can't send the Authorization: Bearer header. Never logged.
no_cachebooleanfalsetrue forces a fresh search (charged). Otherwise identical queries within your plan's cache window are served free.

Example response

Shortened to one item per list.

{
  "search_metadata": {
    "id": "srch_3f9c0d7b2a41e6c8d5b19a70",
    "status": "success",
    "api_version": "v1",
    "endpoint": "ads",
    "provider": "serpapi",
    "cached": false,
    "credits_charged": 1,
    "time_taken_ms": 1840,
    "created_at": "2026-11-20T15:04:05.000Z"
  },
  "search_parameters": {
    "endpoint": "ads",
    "domain": "example.com"
  },
  "domain": "example.com",
  "total_results": 7000,
  "ads": [
    {
      "advertiser_id": "AR09678401900352897025",
      "advertiser_name": "Example Services Company",
      "creative_id": "CR09634365291429363713",
      "format": "text",
      "first_shown": "2022-11-15T08:00:00.000Z",
      "last_shown": "2026-11-20T07:46:14.000Z",
      "image": null,
      "link": "https://adstransparency.google.com/advertiser/AR09678401900352897025/creative/CR09634365291429363713"
    }
  ]
}