{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center API — Advertisers & Ads", "description": "Google's Ads Transparency Center as rows: give brand names, AR ids or domains and get each verified advertiser's profile and its ads — format, first and last shown, days shown, preview link, regions and variations. People advertising under their own name are excluded. No browser, no login, no key.", "version": "0.1", "x-build-id": "4hdvACgueuIhObgvQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insight.solutions~google-ads-transparency-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insight.solutions-google-ads-transparency-api", "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/insight.solutions~google-ads-transparency-api/runs": { "post": { "operationId": "runs-sync-insight.solutions-google-ads-transparency-api", "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/insight.solutions~google-ads-transparency-api/run-sync": { "post": { "operationId": "run-sync-insight.solutions-google-ads-transparency-api", "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", "required": [ "advertisers" ], "properties": { "advertisers": { "title": "Advertisers", "type": "array", "description": "One per line: a **brand name** (`Nike` — resolved through the Center's own advertiser search to the verified advertiser that matches best), an **AR id** (`AR16735076323512287233`) or a Center advertiser link, or a **domain** (`nike.com` — searched through the Center's domain filter, which returns the ads that point at it). At most 200 entries per run; duplicates are read once.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Where the ads were shown: a two-letter country code (`US`, `GB`, `DE`, …; `UK` is read as `GB`), or `anywhere` for no region filter. Rows link to the Center's pages for this region.", "default": "US" }, "formats": { "title": "Ad formats", "type": "array", "description": "Only these formats: any of `text`, `image`, `video`. Empty (or all three) means every format. With two formats, each gets half of the per-advertiser limit, and a format that runs out hands its share to the other.", "items": { "type": "string", "enum": [ "text", "image", "video" ], "enumTitles": [ "Text (search ads)", "Image", "Video" ] }, "default": [] }, "maxAdsPerAdvertiser": { "title": "Ads per advertiser", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many ads are returned per advertiser (per domain, for a domain entry), newest last-shown first. The Center answers 40 per request, so 200 ads is 5 requests. Each ad is one `ad` row.", "default": 200 }, "maxAdvertisersPerName": { "title": "Advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many verified advertisers to take for each brand name, best match first: the name itself (legal suffixes ignored), then the largest ad count, then the same country as `region`. Raise it to also read a brand's regional entities (`Nike, Inc.` and `NIKE SRL`). AR ids and domains are not affected.", "default": 1 }, "includeRegions": { "title": "Regions and variations per ad", "type": "boolean", "description": "Look each ad up once more to fill `regions` (every country the Center says it was shown in), `variationCount` and `variationPreviews`. One extra request per ad, so a run takes about twice as long. It costs time, not money: the `ad` price is the same.", "default": false }, "includeDuns": { "title": "DUNS numbers", "type": "boolean", "description": "Fill `dunsNumber` on advertiser rows from the Center's own advertiser-to-DUNS list, read once per run (about 300 KB). Not every advertiser has one.", "default": false }, "sinceDate": { "title": "Shown on or after", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only ads last shown on or after this day (`2026-09-01`). The Center has no date filter of its own, so ads outside the dates are read and dropped before they are returned — never billed. Leave empty for no limit." }, "untilDate": { "title": "First shown on or before", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only ads first shown on or before this day (`2026-10-31`). With `sinceDate`, the ads that ran at any time inside the window. Leave empty for no limit." }, "maxConcurrency": { "title": "Requests in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests are in flight at once, across advertisers and per-ad lookups (1–10).", "default": 4 }, "maxRunSecs": { "title": "Maximum run time (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Wall-clock budget for the whole run. When it is reached the Actor stops reading, keeps — and bills — every row it already wrote (with each started advertiser's profile), and files a free `timeout` row for what it did not finish.", "default": 240 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy by default — the Center answers it, and every request goes through it. A rate-limited request is retried at most twice, each time from a fresh proxy session.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }