Google ad details

When to use this

Use it after company ads (google_company_ads) for one ad's versions, regions and landing page. Pass the ad's Transparency Center link as url, or advertiser_id + creative_id.

Each version has an imageUrl when Google archived it as a picture, else a previewUrl. For text and video ads we also read one live preview for the headline, description, landing page and YouTube video; image-only text stays null (we don't OCR). Impressions, spend and targeting are only published for political ads.

Returns 404 not_found if the ad doesn't exist.

Parameters

All parameters go in the query string.

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

curl "https://api.lurkapi.com/v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR16735076323512287233%2Fcreative%2FCR11071274990039990273%3Fregion%3DUS" \
  -H "x-api-key: YOUR_API_KEY"

const params = new URLSearchParams({
  url: "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR11071274990039990273?region=US",
});
const res = await fetch(`https://api.lurkapi.com/v1/google/ad?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.creativeRegions);

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/google/ad",
    params={
        "url": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR11071274990039990273?region=US",
    },
    headers={"x-api-key": os.environ["LURKAPI_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["creativeRegions"])

Example response

A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….

{
  "success": true,
  "credits_remaining": 999997,
  "credits_charged": 1,
  "advertiserId": "AR16735076323512287233",
  "creativeId": "CR11071274990039990273",
  "advertiserName": "Nike, Inc.",
  "format": "video",
  "adUrl": "https://adstransparency.google.com/advertiser/AR16735076323512287233/cre…",
  "firstShown": null,
  "lastShown": "2026-09-30T09:58:06.000Z",
  "daysShown": null,
  "overallImpressions": null,
  "spend": null,
  "targeting": null,
  "creativeRegions": [
    {
      "regionCode": "US",
      "regionName": "United States"
    }
  ],
  "regionStats": [
    {
      "regionCode": "US",
      "regionName": "United States",
      "firstShown": null,
      "lastShown": "2026-09-30",
      "impressions": null,
      "platformImpressions": []
    }
  ],
  "variations": [
    {
      "destinationUrl": "https://www.nike.com/retail/",
      "headline": "Engineered for Max Airflow",
      "description": "Maximum breathability meets ultra-light comfort in new Nike Aero-FIT styles.",
      "allText": null,
      "imageUrl": null,
      "previewUrl": "https://displayads-formats.googleusercontent.com/ads/preview/content.js?…",
      "videoId": "RZ1MLoOdWcc"
    },
    {
      "destinationUrl": null,
      "headline": null,
      "description": null,
      "allText": null,
      "imageUrl": null,
      "previewUrl": "https://displayads-formats.googleusercontent.com/ads/preview/content.js?…",
      "videoId": null
    }
  ]
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Caching and freshness

Responses are cached for up to 12 hours, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the google_ad tool. Ask in plain English, for example:

Use LurkAPI's google_ad with url "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR11071274990039990273?region=US" and summarize what you find.

Claude calls google_ad with arguments like these, and each call costs 1 credit:

{
  "url": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR11071274990039990273?region=US"
}

Tool results skip nulls and empty lists to save tokens.