{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper – Advertiser Ads", "description": "Scrape Google's Ads Transparency Center: every ad an advertiser or domain runs, with format, first and last shown dates, days shown, image or preview, a link to the ad and Google's ad count. Look up by name, domain or advertiser ID; filter by country, format and date. No login. Unofficial.", "version": "0.1", "x-build-id": "kNyXO07NM8YyYXge5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simple.actor~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simple.actor-google-ads-transparency", "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/simple.actor~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-simple.actor-google-ads-transparency", "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/simple.actor~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-simple.actor-google-ads-transparency", "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": { "targets": { "title": "Advertisers or websites (one per line)", "type": "array", "description": "Who to look up, one per line. Each line can be a website (nike.com, or any link to it — every ad pointing at that site, from every advertiser, agencies and regional entities included), an advertiser ID (AR16735076323512287233), an advertiser name (Nike — the matching advertiser with the most ads is used), or a link copied from the Ads Transparency Center. For a brand, the website usually finds the most ads.", "items": { "type": "string" } }, "maxAds": { "title": "Ads per advertiser or website", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many ads to return for each line. Ads come newest-shown first, a hundred per request. Every row also carries Google's own count of the advertiser's ads, so you can see how many there are before asking for all of them.", "default": 100 }, "region": { "title": "Country (two-letter code, or anywhere)", "type": "string", "description": "Only ads shown in this country, as a two-letter code: US, GB, DE, IN… Leave it at \"anywhere\" for ads shown in any country — the Transparency Center's own default, and the one that finds the most.", "default": "anywhere" }, "adFormat": { "title": "Format", "enum": [ "any", "text", "image", "video" ], "type": "string", "description": "Only ads of this format. Text ads are mostly kept by Google as a picture of the ad, so their rows carry an image.", "default": "any" }, "shownSince": { "title": "Only ads shown since (date or window)", "type": "string", "description": "Keep only ads Google showed on or after this date — what an advertiser is running now, or ran recently. Takes a date such as 2026-08-01, or a window like \"30 days\". Ads come newest-shown first, so reading stops as soon as older ones begin." }, "firstShownSince": { "title": "Only ads first shown since (date or window)", "type": "string", "description": "Keep only ads Google first showed on or after this date — new ads, for monitoring what an advertiser launches. Takes a date or a window. Unlike the filter above, this one has to look through the advertiser's list to find them, so it can take longer on a big advertiser." }, "includeAdDetails": { "title": "Add the countries each ad ran in", "type": "boolean", "description": "On, every ad row also lists each country the ad was shown in with the last date it ran there, and how many variations of the ad exist. It costs one extra request per ad, so it is slower and charged separately.", "default": false } } }, "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 } } }, "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 } } } } } } } } } }