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
| 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 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.
- 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 itemGoogle 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.
Related APIs
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.