{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper", "description": "Extract public Google Ads Transparency Center creatives by advertiser URL or ID. Return creative IDs, formats, shown dates, advertiser names, preview and image URLs, and region bounds. Filter format and dates before billing; no login or media downloads.", "version": "0.1", "x-build-id": "fkjuxVvE0yYD6qVh9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/schnellscrapers~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-schnellscrapers-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/schnellscrapers~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-schnellscrapers-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/schnellscrapers~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-schnellscrapers-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": { "startUrls": { "title": "Advertiser URLs", "type": "array", "description": "Paste public advertiser pages from Google Ads Transparency Center (for example, https://adstransparency.google.com/advertiser/AR14188379519798214657?region=anywhere). Add one or more URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Provide AR... advertiser IDs when your workflow already has them (for example, AR14188379519798214657). URLs and IDs can be combined.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "anywhere", "US", "GB", "CA", "AU", "DE", "FR", "IN", "JP", "BR", "MX", "ES", "IT", "NL", "SG", "ZA" ], "type": "string", "description": "Choose the country sent to the Transparency Center, or keep Anywhere for the default registry view. Example: US, GB, or DE.", "default": "anywhere" }, "format": { "title": "Creative format", "enum": [ "all", "image", "preview" ], "type": "string", "description": "Keep all creative formats, or emit only image or preview creatives. Filtering happens before dataset writes.", "default": "all" }, "dateFrom": { "title": "First shown from", "type": "string", "description": "Keep creatives first shown on or after this date in YYYY-MM-DD format (for example, 2026-01-01). Leave blank for no lower bound." }, "dateTo": { "title": "Last shown through", "type": "string", "description": "Keep creatives last shown on or before this date in YYYY-MM-DD format (for example, 2026-08-01). Leave blank for no upper bound." }, "includeDetails": { "title": "Fetch creative details", "type": "boolean", "description": "Make one extra public request per kept creative to return variationCount and regionStatCount. Leave off for the lowest-cost first pass.", "default": false }, "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Set the maximum number of creative records to emit across all advertisers. The default is 100; use a higher value for larger exports.", "default": 100 }, "maxPagesPerAdvertiser": { "title": "Maximum pages per advertiser", "minimum": 1, "maximum": 25, "type": "integer", "description": "Limit each advertiser to this many pages, with up to 40 creatives per page. Use 1–3 for focused monitoring and increase for a larger history.", "default": 3 }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Fetch and parse the registry without writing records to the dataset. Use this to verify an input or filter combination.", "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 } } } } } } } } } }