Read everything the Google Ad Library shows for a single ad: every version of the creative, the format, the countries it ran in with the last date it was seen in each, and when it first ran. Pass the full Ad Library ad URL, or an ad id together with its advertiser — an ad id alone is not enough to locate an ad. Note what Google does not publish: ads come back as pictures of the rendered ad, not as separate headline, body and call-to-action fields, so there is no ad copy to read as text. A variation whose kind is rendered has no image at all and only draws in a browser; send it to ad-media to resolve its files.

POST /ad-detail Ads

https://api.fetchlayer.dev/google-ad-library/ad-detail

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

ad string required

Ad id, or an Ad Library ad URL.

advertiser string optional

The ad’s advertiser. Required unless ad is a full Ad Library ad URL.

region string optional

Two-letter country code.

includeRunDates boolean optional

Also report when the ad first ran and how many days it ran. Costs an extra upstream lookup; turn it off if you only need the creative. (default: true)

Response Fields

ad-detail

Get one ad in full

adId string

The resolved ad id.

advertiserId string

The advertiser running the ad.

ad object

The full ad record.

ad.format string

text, image, or video.

ad.firstShownDate string

First day the ad was seen, when includeRunDates is on.

ad.daysShown number

Days the ad was actually shown. Approximate, and lower than the calendar span whenever the ad paused.

ad.regions object[]

Every country the ad ran in, each with regionCode and the last date it was seen there.

ad.variations object[]

Each version of the creative.

ad.variations[].kind string

image carries a picture of the rendered ad at imageUrl. rendered has no image and only draws in a browser — resolve its files with ad-media.

ad.variations[].imageUrl string

Picture of the ad, present when kind is image.

ad.variations[].previewUrl string

Browser preview, present when kind is rendered.

ad.variationCount number

How many creative versions the ad carries.

notes string[]

Caveats about this particular result, such as run dates that could not be resolved.

Request

curl -X POST "https://api.fetchlayer.dev/google-ad-library/ad-detail" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"ad":"CR01234567890123456789","advertiser":"AR01234567890123456789","includeRunDates":true}'

Response

{
  "adId": "CR01234567890123456789",
  "advertiserId": "AR01234567890123456789",
  "ad": {
    "format": "video",
    "firstShownDate": "2026-07-14",
    "daysShown": 48,
    "variationCount": 2,
    "regions": [
      {
        "regionCode": "US",
        "lastShownDate": "2026-08-31"
      },
      {
        "regionCode": "CA",
        "lastShownDate": "2026-08-19"
      }
    ],
    "variations": [
      {
        "index": 0,
        "kind": "rendered",
        "previewUrl": "https://adstransparency.google.com/..."
      }
    ]
  },
  "notes": []
}

{
  "error": "Invalid API key"
}