{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - $1 / 1000 Ads", "description": "Scrape the Google Ads Transparency Center as clean JSON: any advertiser's or website's Google ads (Search, YouTube, Display, Shopping, Maps, Play) with format, dates shown, preview image and ad ids, plus optional reach per country and ad texts. $1 per 1000 ads.", "version": "0.1", "x-build-id": "q4Ygh6PzckmY9slcs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeunblocker~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeunblocker-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/scrapeunblocker~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-scrapeunblocker-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/scrapeunblocker~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeunblocker-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", "properties": { "advertisers": { "title": "Advertisers", "type": "array", "description": "Advertisers to pull ads for: a name (e.g. 'Nike' - matched to the best-fitting advertiser, shown in 'advertisersUsed') or an advertiser id from the Transparency Center (e.g. 'AR16735076323512287233'). Use these or 'Websites' below.", "items": { "type": "string" } }, "domains": { "title": "Websites", "type": "array", "description": "Websites the ads point to, e.g. 'nike.com' - returns the ads of every advertiser that links to that site.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Where the ads were shown: a 2-letter country code ('US', 'DE'), several separated by commas, or empty for anywhere. The first region also decides which per-country reach 'Include details' returns.", "default": "" }, "platform": { "title": "Platforms", "type": "array", "description": "Only ads shown on these Google platforms. Empty = all.", "items": { "type": "string", "enum": [ "search", "youtube", "maps", "play", "shopping" ], "enumTitles": [ "Google Search", "YouTube", "Google Maps", "Google Play", "Google Shopping" ] } }, "format": { "title": "Ad format", "enum": [ "", "text", "image", "video" ], "type": "string", "description": "Only ads of one format.", "default": "" }, "dateFrom": { "title": "Shown from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD)." }, "dateTo": { "title": "Shown until", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "maxResultsPerInput": { "title": "Max ads per advertiser or website", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many ads to collect for each advertiser or website (1-1000), newest shown first.", "default": 100 }, "includeDetails": { "title": "Include details", "type": "boolean", "description": "Add 'details' to every ad: the countries it was shown in with first and last dates (plus impressions per platform for EU countries), EU reach, the targeting the advertiser disclosed, and all ad variations. Billed as an extra 'ad-details' event per ad that comes back with details.", "default": false }, "includePreview": { "title": "Include ad content", "type": "boolean", "description": "Add 'preview' to ads that have a rendered preview: headline, description and display URL of text ads, product title and merchant of shopping ads, image URLs and the YouTube video of video ads. Billed as an extra 'ad-preview' event per ad that comes back with content. Many Search text ads exist only as an image ('imageUrl') and get no preview.", "default": false }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many advertisers or websites to read at the same time (1-5).", "default": 2 } } }, "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 } } } } } } } } } }