{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper · $1.50/1K · Ad Text & New Ads", "description": "Get every Google ad of a competitor from the Ads Transparency Center: ad text, images, YouTube videos, countries, first and last shown dates, impressions and who paid. Search by domain, brand name or advertiser ID, filter by country, platform, format or date, and monitor new ads.", "version": "0.1", "x-build-id": "sKfJzpMbYwbC7Noyl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/featherscrape~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-featherscrape-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/featherscrape~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-featherscrape-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/featherscrape~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-featherscrape-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", "required": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Advertisers or domains", "type": "array", "description": "One per line: a domain (\"nike.com\", returns every advertiser account running ads to it), an advertiser name (\"Nike\"), an advertiser ID (\"AR16735076323512287233\") or an Ads Transparency Center advertiser URL.", "items": { "type": "string" } }, "region": { "title": "Country", "type": "string", "description": "Two-letter country code where the ads were shown (US, GB, FR, DE…). Leave empty for all countries.", "default": "" }, "platform": { "title": "Platform", "enum": [ "any", "search", "youtube", "shopping", "maps", "play" ], "type": "string", "description": "Google product where the ads were shown.", "default": "any" }, "format": { "title": "Ad format", "enum": [ "any", "text", "image", "video" ], "type": "string", "description": "Keep only ads of this format.", "default": "any" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Optional: only ads shown on or after this date (YYYY-MM-DD)." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Optional: only ads shown on or before this date (YYYY-MM-DD)." }, "maxAdsPerSearch": { "title": "Max ads per advertiser or domain", "minimum": 1, "type": "integer", "description": "Maximum number of ads to return for each line, most recently shown first. Large brands can have tens of thousands of ads.", "default": 100 }, "includeDetails": { "title": "Include ad text, countries and impressions", "type": "boolean", "description": "For each ad: headline, description and display URL of text ads, YouTube video of video ads, countries where it ran with dates, impression ranges (EU and political ads), and who paid for it. Turn off for a faster list of ads with dates and preview links only. Same price either way.", "default": true }, "onlyNewAds": { "title": "Only new ads (monitoring mode)", "type": "boolean", "description": "Return only ads not returned by your previous runs with this option on, for each advertiser or domain. Schedule the Actor (e.g. daily) to get a feed of your competitors' new ads and pay only for them.", "default": false }, "maxAdvertisersPerName": { "title": "Advertiser accounts per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "When you enter a name, how many matching advertiser accounts to include (most active first). Brands often run ads from several legal entities; a domain covers them all.", "default": 3 }, "maxResultsTotal": { "title": "Max ads in total", "minimum": 1, "type": "integer", "description": "Optional cap on the total number of ads across all lines, to control your spending." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach Google. The default Apify Proxy works in most cases.", "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 }, "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 } } } } } } } } } }