{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - Ad Copy & Creatives", "description": "[💵 $1.40 / 1K · no start fee] Scrape Google Ads Transparency Center: ad headlines and descriptions, destination URLs, images, YouTube video URLs, verified advertiser identity, dates and formats. Search, YouTube, Shopping, Maps and Play. Many competitors per run.", "version": "0.1", "x-build-id": "mO01EguPFuCe5Urxh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-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/webdata_labs~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-webdata_labs-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/webdata_labs~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-webdata_labs-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": { "queries": { "title": "Keywords, domains or advertiser IDs", "type": "array", "description": "What to track. Each item can be a domain (nike.com), a brand keyword (running shoes), a Google advertiser ID (AR16735076323512287233) or a Transparency Center URL. Add as many as you like - 50 competitors in one run is a normal input, not 50 runs.", "default": [ "nike.com" ], "items": { "type": "string" } }, "region": { "title": "Country", "type": "string", "description": "Two-letter country code the ads were shown in, for example US, GB, DE, BR, IN. Leave empty to search every country. The filter is applied by Google, so you are only charged for ads that match.", "default": "US" }, "platform": { "title": "Google platform", "enum": [ "any", "search", "youtube", "shopping", "maps", "play" ], "type": "string", "description": "Restrict results to ads served on one Google surface. Leave as Any platform to include all of them.", "default": "any" }, "creativeFormat": { "title": "Creative format", "enum": [ "any", "text", "image", "video" ], "type": "string", "description": "Restrict results to one creative format. Text ads are the ones that carry headline and description copy.", "default": "any" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only return ads shown on or after this date (YYYY-MM-DD). Leave empty for no lower bound. Google holds data back to 2018.", "default": "" }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only return ads shown on or before this date (YYYY-MM-DD). Leave empty for no upper bound.", "default": "" }, "maxResults": { "title": "Max ads", "minimum": 0, "type": "integer", "description": "Maximum ad rows across all queries. Set to 0 for unlimited. The low default keeps a first run cheap and fast.", "default": 20 }, "maxResultsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 0, "type": "integer", "description": "Cap the rows any single advertiser can contribute, so one heavy spender cannot eat the whole budget when you track many competitors. 0 means no per-advertiser cap.", "default": 0 }, "includeCreativeAssets": { "title": "Resolve ad copy and creative assets", "type": "boolean", "description": "Fetch each creative's render to extract the headline, description, destination URL, full-resolution images and the YouTube video URL for video ads. Slower per ad, and the only way to get the ad text.", "default": true }, "includeAdvertiserDetails": { "title": "Resolve advertiser identity", "type": "boolean", "description": "Look up each advertiser once to add the verified legal name, the disclosure country and the verification status. Charged once per advertiser, not per ad.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google rate-limits repeat callers by IP, so the Actor rotates proxy sessions on every retry. Residential proxies are the reliable default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }