{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Scraper · No Login · $0.5/1k",
"version": "0.0",
"x-build-id": "FGe3KPcgw1nGGae6h"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alfalfa~google-ads-transparency-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alfalfa-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/alfalfa~google-ads-transparency-scraper/runs": {
"post": {
"operationId": "runs-sync-alfalfa-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/alfalfa~google-ads-transparency-scraper/run-sync": {
"post": {
"operationId": "run-sync-alfalfa-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": {
"advertisers": {
"title": "Advertiser names",
"type": "array",
"description": "Advertiser names as you would type them into the Ads Transparency Center search box, one per line: Nike, Airbnb. The best matching advertiser account is used (set Max advertisers per name for more). Advertiser IDs (AR...) are accepted here too.",
"items": {
"type": "string"
}
},
"domains": {
"title": "Website domains",
"type": "array",
"description": "Websites whose ads to collect, one per line: nike.com, booking.com. Matches every advertiser sending traffic to that domain.",
"items": {
"type": "string"
}
},
"advertiserIds": {
"title": "Advertiser IDs",
"type": "array",
"description": "Ads Transparency Center advertiser IDs, AR followed by digits, from the advertiser page URL.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Ads Transparency Center URLs",
"type": "array",
"description": "Advertiser pages (adstransparency.google.com/advertiser/AR...) or single ad pages (.../advertiser/AR.../creative/CR...) copied from the browser.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"region": {
"title": "Region",
"type": "string",
"description": "Country whose viewers the ads were shown to, as a two-letter code (US, DE, GB). Empty = anywhere in the world."
},
"maxAds": {
"title": "Max ads per source",
"minimum": 1,
"type": "integer",
"description": "Maximum ads per advertiser or domain. Google pages 40 ads at a time; big advertisers have thousands.",
"default": 100
},
"scrapeDetails": {
"title": "Include ad details",
"type": "boolean",
"description": "Open every ad for its regions with last-shown dates, all preview variants and the exact last-shown date. One small request per ad, no surcharge. Off = listing fields only (format, first and last shown, one preview), about twice as fast.",
"default": true
},
"includeMedia": {
"title": "Include media and texts",
"type": "boolean",
"description": "Read the ad previews for the YouTube video id and thumbnail of video ads, image URLs, and the texts of shopping and local ads (product titles, store names). One larger request per preview (see Max previews per ad), no surcharge. Classic text ads come as a screenshot image either way, as on Google's site.",
"default": false
},
"maxPreviews": {
"title": "Max previews per ad",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Preview variants to read per ad when media is on. Most ads have 1-6 variants.",
"default": 3
},
"platforms": {
"title": "Platforms",
"type": "array",
"description": "Only ads shown on these Google surfaces. Empty = all.",
"items": {
"type": "string",
"enum": [
"search",
"youtube",
"maps",
"play",
"shopping"
],
"enumTitles": [
"Google Search",
"YouTube",
"Google Maps",
"Google Play",
"Google Shopping"
]
}
},
"formats": {
"title": "Ad formats",
"type": "array",
"description": "Only text, image or video ads. Empty = all. The filter is applied to the results as they come in, so a run with a format filter reads more pages for the same number of ads; the scan stops after 10,000 ads per source.",
"items": {
"type": "string",
"enum": [
"text",
"image",
"video"
],
"enumTitles": [
"Text",
"Image",
"Video"
]
}
},
"startDate": {
"title": "Shown after",
"type": "string",
"description": "Only ads shown on or after this date, YYYY-MM-DD."
},
"endDate": {
"title": "Shown before",
"type": "string",
"description": "Only ads shown on or before this date, YYYY-MM-DD."
},
"maxAdvertisers": {
"title": "Max advertisers per name",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "How many advertiser accounts to take for one name when several match (Google shows up to 10). Exact name matches come first, then the rest by ad count.",
"default": 1
},
"maxConcurrency": {
"title": "Concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Sources processed in parallel (default 5).",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Residential proxies are included in the price. Leave the default unless you want your own proxy servers.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}