Google Ads Creatives

Fetch public Google Ads Transparency creative records for one advertiser. Supports advertiser ID or Transparency Center advertiser URL.

Execution Model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit Weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
advertiser_id	string	optional	Google Ads Transparency advertiser ID, e.g. AR08888592736429539329. Required unless url is supplied.
url / startUrls	string \| array	optional	Google Ads Transparency advertiser URL. Required unless advertiser_id is supplied.
region	string	optional	Two-letter transparency region code.
limit / resultsLimit	number	optional	Maximum creative rows to return (1-40).
cursor	string	optional	Pagination cursor from a previous response.
date_range	string	optional	Supported value: last_30_days.
skip_details / skipDetails	boolean	optional	Skip detail fetch where supported.
should_download_assets / shouldDownloadAssets	boolean	optional	Download or include asset metadata when available.
should_download_previews / shouldDownloadPreviews	boolean	optional	Download or include preview metadata when available.
ocr	boolean	optional	Include OCR text when available.
timeout_ms	number	optional	Provider timeout in milliseconds (5000-90000).

Response Fields

Field	Type	Description
success	boolean	Whether the request completed successfully.
creatives	array	Creative rows with creative_id, preview_url, format, first/last seen dates, served days, advertiser name, regions, library URL, assets, and OCR text when requested.
cursor	string	Pagination cursor when available.
metadata	object	Provider metadata when available.
time_taken	number	API response time in seconds.

cURL Example

curl -X POST "https://api.datablue.dev/v1/data/google-ads/transparency/creatives" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "advertiser_id": "AR08888592736429539329",
  "region": "IN",
  "resultsLimit": 10
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "source": "google_ads_transparency",
  "operation": "creatives",
  "runtime": "http_rpc",
  "advertiser_id": "AR08888592736429539329",
  "region": "IN",
  "total_results": 1,
  "time_taken": 1.8,
  "creatives": [
    {
      "position": 1,
      "advertiser_id": "AR08888592736429539329",
      "creative_id": "CR123",
      "preview_url": "https://adstransparency.google.com/advertiser/..."
    }
  ]
}