{ "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": "YDblSwdQyaEN2x0Z6" }, "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, newest-shown first, a hundred per request. Every ad returned is charged: with no date filter, this many come back. For new ads, set \"Only ads first shown since\" (firstShownSince) rather than reading them all and filtering afterwards; with it, this is also how far down the list new ads are looked for, so keep it high. Every row carries Google's own count of the advertiser's ads, so a first small run shows how many there are.", "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. Leave it empty and every ad up to \"Ads per advertiser or website\" (maxAds) is returned and charged. Ads come in order of when they were last shown, so new ones can sit below thousands still running: how far down this looks grows with maxAds, so raise that for a big advertiser. Only the ads kept are charged." }, "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 }, "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 } } } } } } } } } }