{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Competitor Ads, Text & Images", "description": "Scrape every ad a company runs on Google Search, Display and YouTube from the Google Ads Transparency Center. Search by domain, advertiser name or ID, any country, date range or format. Get ad text, headlines, images, videos, first/last shown dates and regions.", "version": "1.0", "x-build-id": "oJYwUg691lr6MHl7o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mitp1997~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mitp1997-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/mitp1997~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-mitp1997-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/mitp1997~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-mitp1997-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": { "domains": { "title": "Advertiser domains", "type": "array", "description": "Websites whose ads you want, e.g. nike.com. Returns ads from every advertiser account (including agencies) whose ads point to that domain.", "items": { "type": "string" } }, "advertiserNames": { "title": "Advertiser names", "type": "array", "description": "Company names as shown in the Transparency Center, e.g. \"Flipkart\". The best-matching advertiser (most ads) is used; switch 'Advertiser name matching' to 'all' to include every match.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs or URLs", "type": "array", "description": "Google advertiser IDs (AR followed by digits) or Transparency Center advertiser URLs, e.g. https://adstransparency.google.com/advertiser/AR16735076323512287233.", "items": { "type": "string" } }, "region": { "title": "Region", "type": "string", "description": "Country where the ads were shown, as a 2-letter code (US, GB, IN, DE, ...) or \"anywhere\" for all countries.", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "any", "text", "image", "video" ], "type": "string", "description": "Only return ads of this format.", "default": "any" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD)." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "maxAdsPerQuery": { "title": "Max ads per domain / advertiser", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of ads to return for each domain, name or ID. Ads are returned newest first.", "default": 100 }, "maxItems": { "title": "Max ads in total", "minimum": 1, "type": "integer", "description": "Stop after this many ads across all queries. Leave empty for no limit (the run's max cost still applies)." }, "includeAdDetails": { "title": "Include ad text, images & landing pages", "type": "boolean", "description": "Open each ad's preview to extract headline, description, all visible text, landing page, image URLs and YouTube video. Turn off for a faster list of ads with dates only.", "default": true }, "includeRegions": { "title": "Include regions & impressions", "type": "boolean", "description": "Fetch the countries where each ad ran, with first/last shown per country and impression ranges (impressions are published for EU countries only).", "default": true }, "advertiserNameMatch": { "title": "Advertiser name matching", "enum": [ "best", "all" ], "type": "string", "description": "'best' uses the matching advertiser with the most ads; 'all' scrapes every advertiser whose name matches.", "default": "best" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Parallel requests to Google.", "default": 10 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 8, "type": "integer", "description": "How many times to retry a failed request to Google.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed normally. Enable Apify Proxy only if you see rate-limit errors.", "default": { "useApifyProxy": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }