{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - Ads by Advertiser or Domain", "description": "Google Ads Transparency Center scraper and ad library API alternative: every ad of an advertiser by name, domain or AR ID with format, first and last shown dates, countries, image, YouTube video and preview URLs. Competitor ad research, no login.", "version": "0.1", "x-build-id": "sqyUdHbPbBXNWB4PW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sweet_stickball~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sweet_stickball-google-ads-transparency-scraper", "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/sweet_stickball~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-sweet_stickball-google-ads-transparency-scraper", "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/sweet_stickball~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-sweet_stickball-google-ads-transparency-scraper", "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": [ "advertiser" ], "properties": { "advertiser": { "title": "Advertiser name, domain or ID", "type": "string", "description": "Whose ads to get. Accepted values: (1) a website domain or URL, e.g. 'nike.com' - returns ads that lead to this domain, from every advertiser that runs them; (2) an advertiser ID such as 'AR16735076323512287233' or a Transparency Center advertiser URL - the most precise option; (3) an advertiser name such as 'Nike' - matched against Google's advertiser suggestions (case, punctuation and legal suffixes like 'Inc.' are ignored) and, when several advertisers share the name, the one with the most ads is used. The resolved advertiser is written in the run log." }, "region": { "title": "Region (country code)", "type": "string", "description": "Only ads shown in this country: a two-letter ISO country code such as US, GB (or UK), FR, DE, JP. Leave empty for ads shown anywhere." }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format: text (search ads, archived by Google as an image of the ad), image (display and shopping ads) or video (YouTube ads). 'all' returns every format.", "default": "all" }, "dateRange": { "title": "Date range", "enum": [ "anytime", "last_7_days", "last_30_days", "last_90_days", "last_365_days" ], "type": "string", "description": "Only ads shown at least once in this period, counted back from yesterday (UTC). 'anytime' applies no date filter.", "default": "anytime" }, "maxItems": { "title": "Maximum ads", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of ads (dataset items) to return. Each returned ad is one billed AD event.", "default": 20 }, "includeDetails": { "title": "Include regions and variations", "type": "boolean", "description": "Opens each ad's detail record to fill 'regions' (countries where it ran), 'regionCount' and 'variationCount'. One extra request per ad; turn off for faster runs.", "default": true }, "extractMediaUrls": { "title": "Extract image and video URLs", "type": "boolean", "description": "For image and video ads that Google only shows through a preview script, reads that script to fill 'imageUrl' and, when the video is on YouTube, 'videoUrl'. One extra download (about 200 KB) per such ad.", "default": 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 } } } } } } } } } }