{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Center Scraper: Google Ads Archive",
"description": "Google Ads Transparency Center scraper: export advertiser ad records for competitor research - creative format, available images, first and last shown dates, and source links. Select advertisers and a region; export JSON, CSV or Excel.",
"version": "0.3",
"x-build-id": "Xl18AreD9gqeSfM1x"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/danthedataman~google-ads-archive/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-danthedataman-google-ads-archive",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/danthedataman~google-ads-archive/runs": {
"post": {
"operationId": "runs-sync-danthedataman-google-ads-archive",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/danthedataman~google-ads-archive/run-sync": {
"post": {
"operationId": "run-sync-danthedataman-google-ads-archive",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"advertisers": {
"title": "Advertisers",
"type": "array",
"description": "Advertiser names as Google lists them (e.g. Nike, Inc.) or Google advertiser ids (e.g. AR16735076323512287233). A name is resolved to the closest match and the alternatives are printed in the log, so pass an id when a brand has several registered entities.",
"items": {
"type": "string"
}
},
"region": {
"title": "Region",
"type": "string",
"description": "Which country's ad archive to read. Two-letter code US, GB, DE, IN, CA, AU or JP. For any other country pass Google's numeric region code (2000 + the ISO-3166-1 numeric country code). An advertiser's ads differ by region.",
"default": "US"
},
"maxAdsPerAdvertiser": {
"title": "Max ads per advertiser",
"minimum": 0,
"type": "integer",
"description": "Stop after this many ads for each advertiser. A large advertiser can run thousands (Google reports 9,000-10,000 for Nike in the US alone), so this is the main cost control. 0 means no per-advertiser limit.",
"default": 100
},
"maxItems": {
"title": "Max results in total",
"minimum": 0,
"type": "integer",
"description": "Stop the whole run after this many rows. 0 means no overall limit.",
"default": 0
},
"maxRunSeconds": {
"title": "Run time budget (seconds)",
"minimum": 0,
"type": "integer",
"description": "Stop starting new pages after this many seconds, so a Google-side slowdown cannot burn a long run. 0 disables the budget.",
"default": 900
},
"maxRetriesPerRequest": {
"title": "Max retries per request",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How hard to retry when Google rate-limits a request. Each retry backs off and rotates onto a fresh proxy IP.",
"default": 8
},
"rotateAfterRequests": {
"title": "Rotate proxy IP every N requests",
"minimum": 0,
"maximum": 200,
"type": "integer",
"description": "Retire each proxy identity after this many requests, before Google throttles it. 0 disables proactive rotation.",
"default": 24
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "The Transparency Center rate-limits a single address with HTTP 429 during sustained reading. Keeping Apify Proxy enabled is strongly recommended.",
"default": {
"useApifyProxy": true
}
},
"includeRotationSummary": {
"title": "Include creative rotation summary",
"type": "boolean",
"description": "Opt-in add-on. When on, the run writes one per-advertiser creative-rotation summary to the ROTATION_SUMMARY key-value record (never the dataset) and charges the custom event advertiser-rotation-summary once per summarized advertiser that has at least one collected row carrying both firstShownTimestamp and lastShownTimestamp. coverage is complete only when Google returned no further page; duplicatePage (a page held only already-collected creatives) and repeatedToken (Google repeated a pagination token) are partial stop reasons. Off by default: no summary, no add-on charge.",
"default": false
},
"activeWithinDays": {
"title": "Window for last-shown count (days)",
"minimum": 1,
"type": "integer",
"description": "Look-back window in whole days, counted from the instant this run started collecting (scrapedAt, shared by every advertiser so summaries are comparable). shownWithinWindow is the count of collected creatives whose lastShownTimestamp falls in that window, inclusive of the exact boundary (lastShownTimestamp >= scrapedAt minus this many days). It is not a count of \"active ads\" except under this definition. coverage is complete only when Google returned no further page; duplicatePage and repeatedToken are partial stop reasons. Minimum 1.",
"default": 7
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}