{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Scraper: Ad Copy, Videos & Spend",
"description": "Scrape every ad a company runs on Google Search, YouTube, Shopping, Maps and Play from the Google Ads Transparency Center. Search by brand, domain or advertiser ID. Get ad copy, CTAs, landing URLs, YouTube video IDs, run dates, countries and political ad spend. Monitor competitors for new ads.",
"version": "0.1",
"x-build-id": "Pn9862xWZ2dD8JCAw"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/sholkany_the_goat~google-ads-transparency-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-sholkany_the_goat-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/sholkany_the_goat~google-ads-transparency-scraper/runs": {
"post": {
"operationId": "runs-sync-sholkany_the_goat-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/sholkany_the_goat~google-ads-transparency-scraper/run-sync": {
"post": {
"operationId": "run-sync-sholkany_the_goat-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, domains or URLs",
"type": "array",
"description": "What to look up. Each line can be an advertiser name (Nike), a website domain (nike.com finds every advertiser sending traffic there), an advertiser ID (AR16735076323512287233), or any Transparency Center URL (advertiser page, single ad, or ?domain= search).",
"default": [],
"items": {
"type": "string"
}
},
"maxAdsPerSearch": {
"title": "Max ads per search",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Maximum number of ads to save for each line above. When a name matches several advertisers (see below), the limit applies to each advertiser. Ads come newest-shown first.",
"default": 100
},
"maxAdvertisersPerSearch": {
"title": "Advertisers per name search",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "When a line is a name, how many matching advertisers to scrape. The biggest advertiser (most ads) whose name contains your words is picked first. Raise it to include regional subsidiaries, e.g. 'Nike, Inc.' and 'Nike Retail BV'.",
"default": 1
},
"format": {
"title": "Ad format",
"enum": [
"ALL",
"TEXT",
"IMAGE",
"VIDEO"
],
"type": "string",
"description": "Only return ads of this format.",
"default": "ALL"
},
"platforms": {
"title": "Platforms",
"type": "array",
"description": "Only return ads shown on these Google platforms. Leave empty for all. Google only records the platform for ads shown since 4 September 2023.",
"items": {
"type": "string",
"enum": [
"SEARCH",
"YOUTUBE",
"SHOPPING",
"MAPS",
"PLAY"
],
"enumTitles": [
"Google Search",
"YouTube",
"Google Shopping",
"Google Maps",
"Google Play"
]
},
"default": []
},
"regions": {
"title": "Countries",
"type": "array",
"description": "Only return ads shown in these countries. Use two-letter ISO codes such as US, GB, DE, MY. Leave empty for anywhere.",
"default": [],
"items": {
"type": "string"
}
},
"startDate": {
"title": "Shown since",
"type": "string",
"description": "Only ads shown on or after this date. A date (2026-01-01) or a relative value such as '30 days' (meaning 30 days ago)."
},
"endDate": {
"title": "Shown until",
"type": "string",
"description": "Only ads shown on or before this date. Leave empty for today."
},
"politicalAdsOnly": {
"title": "Political ads only (with spend and impressions)",
"type": "boolean",
"description": "Return only election ads. These include Google's spend range, impressions range and targeted regions. Political ads are published for a limited set of countries, so set Countries too.",
"default": false
},
"extractAdContent": {
"title": "Extract ad copy, images and video IDs",
"type": "boolean",
"description": "Decode each ad's preview to get its text, call to action, display URL, landing URLs, image URLs and YouTube video ID. Charged as an extra 'ad content' event only when content is found. Ads that Google publishes only as a screenshot have no extractable text unless you also turn on details.",
"default": true
},
"includeAdDetails": {
"title": "Include countries where each ad ran",
"type": "boolean",
"description": "Fetch each ad's detail page: the list of countries it was shown in (with last-shown date per country) and the number of variations. Also recovers copy for many text ads. Charged as an extra 'ad details' event.",
"default": false
},
"onlyNewAds": {
"title": "Only new ads (monitoring)",
"type": "boolean",
"description": "Skip ads already returned by earlier runs with the same monitor key. Schedule the Actor daily or weekly to get only new creatives, and pay only for those.",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Name for the list of ads already seen. Runs with the same key share the list. Leave empty to derive it from the search terms and filters."
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Google limits requests per IP address, so the Actor rotates proxy IPs. The default datacenter proxy works well.",
"default": {
"useApifyProxy": true
}
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many requests to Google run in parallel.",
"default": 5
}
}
},
"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
}
}
}
}
}
}
}
}
}
}