Google Ad Library

Google Ad Details API

Google publishes spend and impression ranges only for election ads; commercial advertisers omit both.

Google publishes spend and impression ranges only for election ads in regions that require disclosure; commercial advertisers omit both. isActive is derived from lastShown — true when the creative was seen within 7 UTC days. Paste a Google Ads Transparency URL with both AR… advertiser and CR… creative IDs. This is ID lookup, not a richer scrape: same commercial SearchCreatives payload as a company-ads row. Response id and advertiser.id always match the request. Flat 2 credits native; the fallback path is capped at 5.

Docs: https://captapi.com/apis/google-ad-library-ad-details

get/v1/ad-library/google/ad-details

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/ad-library/google/ad-details
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

creative_idstring required

Google Ads Transparency URL containing AR... advertiser and CR... creative IDs. A creative that does not exist under the advertiser is a definitive 404 AD_NOT_FOUND (upstream answered) — 503 is reserved for actual transport failures.

countrystring

Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.