Google Ad Library

Retrieves detailed information about a specific Google ad including advertiserId, creativeId, format, firstShown, lastShown, and overallImpressions. firstShown can be null even when /v1/google/company/ads returns a date for the same ad; keep the company-list date when this field is null. When Google publishes political-ad transparency data, spend contains the currency and amount bounds, while targeting contains included and excluded age, gender, and location criteria. Targeted locations include their Google criterion ID, display name, full name, and country codes. Optional fields are null when Google does not publish them. regionStats and platformImpressions use lower and upper impression bounds. Variations are best-effort, omit unparseable entries, and have creative-type-dependent fields; image creatives can expose an images array. Text extraction uses OCR, so accuracy may vary.

get/v1/google/ad

Request

  • Base URL
    https://api.scrapecreators.com
  • URL
    https://api.scrapecreators.com/v1/google/ad
  • Auth
    API key in header x-api-key

Query parameters

urlstring required

The url of the ad

cache_max_age'1d' | '3d' | '7d' | '14d' | '30d'

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.

Response

Successful response

Changes