{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Scraper & Ad Monitor",
"description": "Get competitors' Google ads from the Ads Transparency Center by domain, advertiser name or ID: formats, first/last shown dates, previews, and optionally ad text, landing pages, countries and impressions. Monitoring mode returns only new ads on each scheduled run. No login, no proxies.",
"version": "0.1",
"x-build-id": "lieYLaRfkqgnNkHCp"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/koivu-data~google-ads-transparency-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-koivu-data-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/koivu-data~google-ads-transparency-scraper/runs": {
"post": {
"operationId": "runs-sync-koivu-data-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/koivu-data~google-ads-transparency-scraper/run-sync": {
"post": {
"operationId": "run-sync-koivu-data-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": [
"targets"
],
"properties": {
"targets": {
"title": "Advertisers or domains",
"type": "array",
"description": "One per line. Accepted: a website domain (nike.com, ads of every advertiser that promotes it), an advertiser name (Zalando SE, resolved with Google's own search), an advertiser ID (AR16735076323512287233) or a link copied from adstransparency.google.com (advertiser page, single ad or domain search; filters in the link such as region are applied).",
"default": [
"nike.com"
],
"items": {
"type": "string"
}
},
"maxAdsPerTarget": {
"title": "Max ads per target",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Maximum number of ads saved per line, most recently shown first. You only pay for ads that are saved.",
"default": 100
},
"includeAdDetails": {
"title": "Include ad details (ad text, landing page, countries, impressions)",
"type": "boolean",
"description": "Opens every ad: headline and description when Google provides them as text, display and landing URL, YouTube video ID, product title for Shopping ads, all image variations, countries where the ad ran with first/last shown dates and impression ranges per platform, EU (DSA) audience targeting categories and the paying entity. Costs one extra event per ad and makes the run slower.",
"default": false
},
"onlyNewAds": {
"title": "Only new ads since the last run (monitoring)",
"type": "boolean",
"description": "For scheduled runs. Returns only ads that are new since the previous run of the same task (also ads that Google publishes a few days late). The first run returns the most recently launched ads and remembers all currently running ones, so old ads are never reported as new. State is kept per saved task.",
"default": false
},
"region": {
"title": "Region",
"enum": [
"",
"AF",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AQ",
"AG",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BT",
"BO",
"BA",
"BW",
"BR",
"BN",
"BG",
"BF",
"BI",
"CV",
"KH",
"CM",
"CA",
"BQ",
"CF",
"TD",
"CL",
"CN",
"CX",
"CC",
"CO",
"KM",
"CK",
"CR",
"CI",
"HR",
"CW",
"CY",
"CZ",
"CD",
"DK",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"SZ",
"ET",
"FJ",
"FI",
"FR",
"PF",
"TF",
"GA",
"GE",
"DE",
"GH",
"GR",
"GD",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"HN",
"HU",
"IS",
"IN",
"ID",
"IQ",
"IE",
"IM",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KI",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MG",
"MW",
"MY",
"MV",
"ML",
"MT",
"MH",
"MR",
"MU",
"MX",
"FM",
"MD",
"MC",
"MN",
"ME",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NL",
"NC",
"NZ",
"NI",
"NE",
"NG",
"NU",
"NF",
"MK",
"MP",
"NO",
"OM",
"PK",
"PW",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PL",
"PT",
"QA",
"CG",
"RO",
"RU",
"RW",
"BL",
"SH",
"KN",
"LC",
"MF",
"PM",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SL",
"SG",
"SX",
"SK",
"SI",
"SB",
"SO",
"ZA",
"GS",
"KR",
"SS",
"ES",
"LK",
"SD",
"SR",
"SE",
"CH",
"SY",
"TJ",
"TZ",
"TH",
"BS",
"GM",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TV",
"UG",
"UA",
"AE",
"GB",
"US",
"UM",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"WF",
"YE",
"ZM",
"ZW"
],
"type": "string",
"description": "Only ads shown in this country. Leave empty for all regions.",
"default": ""
},
"adFormat": {
"title": "Ad format",
"enum": [
"ALL",
"TEXT",
"IMAGE",
"VIDEO"
],
"type": "string",
"description": "Text ads, image ads (incl. Shopping) or video ads.",
"default": "ALL"
},
"platform": {
"title": "Platform",
"enum": [
"ALL",
"SEARCH",
"YOUTUBE",
"SHOPPING",
"MAPS",
"PLAY"
],
"type": "string",
"description": "Where the ad was shown. Google applies this filter to ads shown since September 2023.",
"default": "ALL"
},
"dateFrom": {
"title": "Shown on or after",
"type": "string",
"description": "Optional. Only ads that were shown at least once in the date range. Absolute (2026-09-01) or relative (30 days, 3 months). Google supports date filters for about the last 12 months."
},
"dateTo": {
"title": "Shown on or before",
"type": "string",
"description": "Optional end of the date range (inclusive). Defaults to today when only the start is set."
},
"maxAdvertisersPerName": {
"title": "Advertisers per name search",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "When a line is an advertiser name, how many matching advertiser accounts to include (largest first). The run summary lists the matches, so you can switch to exact advertiser IDs.",
"default": 1
},
"stateKey": {
"title": "Monitoring state key",
"type": "string",
"description": "Advanced. Name of the memory slot used by 'Only new ads'. Leave empty to use the task ID automatically."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Not needed for normal use. Enable only if you run very large volumes and see 'rate limited by Google' warnings.",
"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
}
}
}
}
}
}
}
}
}
}