{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper", "description": "Scrape public Google Ads Transparency Center advertisers and ad creatives for competitive research.", "version": "0.1", "x-build-id": "3ENbYBk4R9RhkMJPR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~google-ads-transparency-center-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-google-ads-transparency-center-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/automation-lab~google-ads-transparency-center-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-google-ads-transparency-center-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/automation-lab~google-ads-transparency-center-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-google-ads-transparency-center-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": "Search queries / domains", "type": "array", "description": "Advertiser names, keywords, or domains to search in Google Ads Transparency Center. The global result limit is distributed across queries in input order so one productive search cannot consume capacity reserved for every later search. Examples: nike.com, tesla, shopify.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Optional Google Ads Transparency advertiser IDs (for example AR16735076323512287233). When set, creative search is restricted to these advertisers.", "items": { "type": "string" } }, "searchMode": { "title": "Search mode", "enum": [ "creatives", "advertisers" ], "type": "string", "description": "Choose whether to export ad creatives or advertiser/domain suggestions.", "default": "creatives" }, "adFormats": { "title": "Ad formats", "type": "array", "description": "Keep only creative rows in the selected normalized formats. Leave empty to include every format. This filter does not apply to advertiser suggestion rows.", "items": { "type": "string", "enum": [ "text-image", "image", "video", "text" ], "enumTitles": [ "Text / image", "Image", "Video", "Text" ] }, "default": [] }, "onlyAdsNewerThan": { "title": "Active on or after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional inclusive YYYY-MM-DD lower bound. A creative is retained when its first-to-last shown activity interval overlaps this date or a later date." }, "onlyAdsOlderThan": { "title": "Active on or before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional inclusive YYYY-MM-DD upper bound. A creative is retained when its first-to-last shown activity interval overlaps this date or an earlier date." }, "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of dataset rows to save across all queries. Capacity is shared fairly in input order; if this is lower than the number of queries, only the earliest queries up to this limit can be checked.", "default": 20 }, "regionCriteriaId": { "title": "Google region criteria ID", "minimum": 1, "type": "integer", "description": "Google geo criterion ID used by the Transparency Center API. 2840 is United States.", "default": 2840 }, "regionCode": { "title": "Region code label", "type": "string", "description": "Human-readable region code saved in output and source URLs. This does not change the API filter unless regionCriteriaId is also changed.", "default": "US" }, "includeAdvertiserSuggestions": { "title": "Also save advertiser suggestions", "type": "boolean", "description": "When enabled in creative mode, the actor first saves advertiser/domain suggestions before ad creative rows.", "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 } } } } } } } } } }