{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ads, Text & Videos", "description": "Scrape Google Ads Transparency Center: all Search, Display and YouTube ads of any advertiser or domain with headline and ad copy, images, YouTube video IDs, first and last shown dates and countries. Filter by region, format and date.", "version": "0.1", "x-build-id": "rfGUeTeCpzaSCFXgV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tindacloud~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tindacloud-google-ads-transparency", "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/tindacloud~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-tindacloud-google-ads-transparency", "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/tindacloud~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-tindacloud-google-ads-transparency", "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": { "searchTerms": { "title": "Advertiser search", "type": "array", "description": "Brand or company names. The top matching advertisers (by number of ads) are scraped.", "items": { "type": "string" } }, "advertisersPerSearchTerm": { "title": "Advertisers per search term", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many matching advertiser accounts to take for each search term.", "default": 3 }, "domains": { "title": "Domains", "type": "array", "description": "Get all ads that link to these domains, from any advertiser (e.g. nike.com).", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs or URLs", "type": "array", "description": "AR… IDs or adstransparency.google.com advertiser URLs.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code where ads were shown (US, GB, DE, KR…), or 'anywhere'.", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Filter by creative format.", "default": "all" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date." }, "includeAdContent": { "title": "Extract ad text & video", "type": "boolean", "description": "Read each ad preview to extract headline and ad copy, call to action, image URL and YouTube video ID. Same price.", "default": true }, "includeDetails": { "title": "Include regions", "type": "boolean", "description": "Adds the countries where each ad was shown (with last shown date) and number of variations.", "default": true }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser / domain", "minimum": 1, "type": "integer", "description": "Newest ads first.", "default": 100 }, "onlyNewAds": { "title": "Only ads that are new", "type": "boolean", "description": "Monitoring mode. Remembers which ads you already pulled and returns only ads that appeared since the last run. Put it on a daily schedule to watch a competitor's new campaigns — you pay only for new ads.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many ads. You are charged per ad.", "default": 1000 }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy works for the Ads Transparency Center.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }