Google Ad · ScrapeSocial

GET/v1/google/ad1 credit

Returns the details of a single ad from the Google Ads Transparency Center: format, first and last shown dates, impressions, spend, targeting, per-region statistics and the ad's variations (headlines, descriptions, images, landing pages).

01Query parameters

Name	Type	Description
urlrequired	string	Ad URL on the Ads Transparency Center, like `https://adstransparency.google.com/advertiser/AR…/creative/CR…`.
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01614014350098432001%2Fcreative%2FCR07329434885456658433" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01614014350098432001%2Fcreative%2FCR07329434885456658433

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "advertiserId": "AR01614014350098432001",
  "creativeId": "CR07329434885456658433",
  "firstShown": null,
  "url": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR07329434885456658433",
  "lastShown": "2026-10-25T09:59:03.000Z",
  "format": "image",
  "overallImpressions": {
    "min": null,
    "max": null
  },
  "spend": null,
  "targeting": null,
  "creativeRegions": [
    {
      "regionCode": "CA",
      "regionName": "Canada"
    }
  ],
  "regionStats": [
    {
      "regionCode": "CA",
      "regionName": "Canada",
      "firstShown": null,
      "lastShown": "2026-10-25T00:00:00.000Z",
      "impressions": {},
      "platformImpressions": []
    }
  ],
  "variations": [
    {
      "destinationUrl": null,
      "headline": "lululemon ABC Classic-Fit Trouser 32L Warpstreme - Size 46 - Raw Linen",
      "image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcR6dJCAAgY2ZffeJZvFyUuPiZYMz2gYlReg8QAgVvDgYrGxovoI",
      "description": "lululemon"
    },
    {
      "destinationUrl": null,
      "headline": "lululemon ABC Classic-Fit Trouser 30L Warpstreme - Size 34 - Black",
      "image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSbbg3QZ02ffhxQsLx1cP1xoYw240Mdia0vllzTGjLouVZBUGE",
      "description": "lululemon"
    }
  ]
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Impressions, spend and targeting are often published only for political ads; when Google does not publish them they are null (`overallImpressions` has null `min` and `max`). Variations are read from the ad's own markup: an ad that is only an image yields just its image URLs, with no extracted text. An ad that Google no longer shows, or shows only to signed-in viewers, is a free 404; a URL that is not an Ads Transparency Center ad is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.