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.
Features
- Exact creative resolutionResolve 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.
Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | Required 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
Submit one exact public creative URL, track the asynchronous task, and read the normalized ad record from the standard result envelope.
- Prepare one http or https URL on adstransparency.google.com whose path contains /creative/.
- POST url to /v1/google-ad-library/ad and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or fails.
- 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 itemBest 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.
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.
Related APIs
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.