Google Ad Library Ad Details API

Get the details for an ad. I'm using an OCR to get the text from the ad, so it might not be 100% accurate. If you find any errors or irregularities, please email me: support@scrapecreators.com

1 creditper request
GET
/v1/google/ad
curl "https://api.scrapecreators.com/v1/google/ad" \
  -H "x-api-key: "
{
  "success": true,
  "credits_remaining": 1000000,
  "credits_charged": 1,
  "advertiserId": "AR01614014350098432001",
  "creativeId": "CR07443539616616939521",
  "firstShown": null,
  "lastShown": "2025-06-18T18:09:00.000Z",
  "format": "text",
  "overallImpressions": {
    "min": "250000",
    "max": "300000"
  },
  "spend": {
    "currency": "USD",
    "lower": "5000",
    "upper": "6000"
  },
  "targeting": {
    "age": {
      "included": [
        "25-34",
        "35-44",
        "45-54",
        "55-64",
        "65+",
        "unknown"
      ],
      "excluded": [
        "18-24"
      ]
    },
    "gender": {
      "included": [
        "unknown",
        "male",
        "female"
      ],
      "excluded": []
    },
    "location": {
      "included": [
        {
          "criterionId": "1015229",
          "name": "West Palm Beach",
          "fullName": "West Palm Beach, Florida, United States",
          "countryCodes": [
            "US"
          ]
        },
        {
          "criterionId": "1015158",
          "name": "Palm Beach",
          "fullName": "Palm Beach, Florida, United States",
          "countryCodes": [
            "US"
          ]
        },
        {
          "criterionId": "200548",
          "name": "West Palm Beach-Ft. Pierce FL",
          "fullName": "West Palm Beach-Ft. Pierce FL, Florida, United States",
          "countryCodes": [
            "US"
          ]
        }
      ],
      "excluded": []
    }
  },
  "creativeRegions": [
    {
      "regionCode": "US",
      "regionName": "United States"
    }
  ],
  "regionStats": [
    {
      "regionCode": "US",
      "regionName": "United States",
      "firstShown": null,
      "lastShown": "2025-06-18T05:00:00.000Z",
      "impressions": {
        "lower": "1000",
        "upper": "4999"
      },
      "platformImpressions": [
        {
          "platform": "Google Search",
          "impressions": {
            "lower": "100",
            "upper": "999"
          }
        }
      ]
    }
  ],
  "variations": [
    {
      "images": [
        "https://tpc.googlesyndication.com/archive/simgad/2201045439314643090"
      ]
    }
  ]
}

Headers

x-api-key
string
required

Your Scrape Creators API key

Query Parameters

url
string
required

The url of the ad

Example:
https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217
cache_max_age
string

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details.

Example:
7d
Available options:
1d,
3d,
7d,
14d,
30d