{ "openapi": "3.0.1", "info": { "title": "Google Ads Scraper", "description": "Scrape advertiser data, ad creatives, impressions, audience targeting, and ad media from the Google Ads Transparency Center.", "version": "1.0", "x-build-id": "UwR4mXhxzhvJNliYS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ayen-data~google-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ayen-data-google-ads-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/ayen-data~google-ads-scraper/runs": { "post": { "operationId": "runs-sync-ayen-data-google-ads-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/ayen-data~google-ads-scraper/run-sync": { "post": { "operationId": "run-sync-ayen-data-google-ads-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Google Ads Transparency Center URLs to scrape. Supported formats:\n\n- Advertiser search: `https://adstransparency.google.com/advertiser/?region=`\n- Creative detail: `https://adstransparency.google.com/advertiser//creative/?region=`\n- Domain search: `https://adstransparency.google.com/?region=anywhere&domain=`", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items per start URL", "minimum": 1, "type": "integer", "description": "Maximum number of ad creatives to scrape per advertiser search URL. Detail URLs always return a single item.", "default": 10 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy configuration. Defaults to no proxy. Enable Apify Proxy if you experience rate limiting or geo-restrictions.", "default": { "useApifyProxy": false } }, "cookies": { "title": "Cookies (optional)", "type": "array", "description": "Provide cookies to access additional data such as age-restricted ad creatives.\n\n1. Install the Cookie-Editor Chrome extension.\n2. Open https://adstransparency.google.com and log in to your Google account.\n3. Open Cookie-Editor and export cookies as JSON.\n4. Paste the exported JSON here.", "default": [] }, "notionConnector": { "title": "Notion Connector (optional)", "type": "string", "description": "Optional Notion connection. When set, every scraped ad creative is added as a new page in the selected Notion database." }, "notionDatabaseId": { "title": "Notion Database ID", "type": "string", "description": "ID of the Notion database that will receive the new pages. The database must have a title property named `Name`. Required when a Notion Connector is selected." }, "airtableConnector": { "title": "Airtable Connector (optional)", "type": "string", "description": "Optional Airtable connection. When set, every scraped ad creative is appended as a new record in the selected Airtable table." }, "airtableBaseId": { "title": "Airtable Base ID", "type": "string", "description": "ID of the target Airtable base (starts with `app...`). Open the base in Airtable — the ID is the second path segment of the URL. Required when an Airtable Connector is selected." }, "airtableTableId": { "title": "Airtable Table ID", "type": "string", "description": "ID of the target Airtable table (starts with `tbl...`). Open the table in Airtable — the ID is the third path segment of the URL. Required when an Airtable Connector is selected." }, "downloadMedia": { "title": "Download ad media", "type": "boolean", "description": "When enabled, the actor downloads each ad's preview image and variant media (images and videos) and includes references to the saved files in the output. Leave disabled to capture media URLs only.", "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 } } } } } } } } } }