google-ad-library/
ad

The Google Ad Library Ad API retrieves one public Google Ads Transparency Center creative from its exact URL, returning advertiser identity, copy, media, delivery dates, regions, format, destination, and available impressions in a normalized record.

Google Ad Library Ad API

Exact creative URL
Advertiser and media
Public delivery context
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Google Ad Library Ad

Google Ads Transparency Center creatives are public advertising records with advertiser identity, visible copy and media, destination links, formats, delivery dates, regions, and available impression data. These details support creative verification, selected-ad enrichment, delivery-context research, and point-in-time archive comparisons.

Google Ad Library Ad API Features

  • Exact creative resolutionThe Google Ad Library Ad API resolves one adstransparency.google.com URL containing /creative/ into at most one normalized public ad record without broadening the request into search.
  • Advertiser and creative fieldsReturn the creative identifier, public source URL, available text, advertiser reference, destination, and format in a stable ad schema.
  • Delivery contextPreserve available start and end dates, countries, placements, and a scalar impression value only when the source data can be normalized safely.
  • Normalized media assetsExpose available image or video references with thumbnails, dimensions, and duration while omitting absent optional values.

Google Ad Library Ad API Parameters

ParametersRequiredDescription
urlRequiredRequired public Google Ads Transparency Center creative URL. The scheme must be http or https, the host must end with adstransparency.google.com, and the path must contain /creative/.

How to Use the Google Ad Library Ad API

Submit one exact public creative URL to the Google Ad Library Ad API, track the asynchronous task, and read the normalized ad record from the standard result envelope.

  1. Prepare one http or https URL on adstransparency.google.com whose path contains /creative/.
  2. POST url to /v1/google-ad-library/ad and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails.
  4. Read data.results.items; the detail operation returns at most one item, so has_more is normally false and next_cursor is normally null.
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Google Ad Library Ad API Use Cases

  • Enrich a selected creative: Use the creative ID, advertiser reference, copy, destination, format, media, and source URL to complete a previously discovered ad record.
  • Review public delivery evidence: Compare available dates, countries, placements, and impressions to document where and when a known creative was publicly observed.
  • Archive creative snapshots: Store normalized text, media, advertiser, delivery, destination, and collected_at fields for later point-in-time comparison.

Google Ad Library Ad API Pro Tips

  • Submit the complete creative URL rather than a bare CR identifier or advertiser URL so the host and /creative/ path pass validation.
  • Treat a succeeded task with no item separately from a provider failure; a removed, restricted, or unavailable creative can yield no usable record.
  • Preserve nullable delivery, text, destination, advertiser, impression, and media fields instead of converting missing public values to zero or empty claims.
  • Use advertiser search and company ads for discovery or inventory work; this detail operation deliberately resolves only the submitted creative.

Beyond the Google Ad Library Ad API, use these APIs when you need a different type of public Google Ad Library data.

  • Google Ad Library Advertiser Search API — Discover public Transparency Center advertiser candidates by query and optional region with identity, website, logo, region, and available ad-count fields.
  • Google Ad Library Company Ads API — Collect public Transparency Center creatives by company domain or advertiser ID with topic, region, date, surface, format, and result-limit controls.

Explore other platforms

Combine Google Ad Library data with public data from other supported social platforms.

Google Ad Library Ad API — FAQ

Google Ad Library Ad API is a programmatic interface for retrieving one public Google Ads Transparency Center creative from its exact URL. It returns normalized advertiser, copy, media, delivery, region, format, destination, and available impression fields.

Submit one http or https URL whose host ends with adstransparency.google.com and whose path contains /creative/. Bare creative IDs, advertiser URLs, domains, queries, and URL lists are not accepted.

The normalized record declares identity, source URL, text, advertiser, delivery dates, countries, platforms, format, destination, impressions, media, publication time, and collection time. Source-dependent fields remain nullable, and media can be empty.

A valid creative URL can refer to a removed, restricted, malformed, or currently unavailable public record. The endpoint does not substitute another creative or turn the request into a search.

Each returned record costs 0.5 SocQ credits. The configured empty-result policy charges only the zero-credit base when no record is returned.