{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Scraper & Competitor Monitor",
"description": "Scrape Google ads (Search, YouTube, Shopping, Maps, Play) for any advertiser or domain from the Ads Transparency Center. Monitor competitors for new, stopped and new-country ads with Slack/webhook alerts, or bulk-check which domains advertise.",
"version": "0.1",
"x-build-id": "qNzBXohRckQnAOE0i"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/kingly_contest_7cb~google-ads-transparency-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-kingly_contest_7cb-google-ads-transparency-monitor",
"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/kingly_contest_7cb~google-ads-transparency-monitor/runs": {
"post": {
"operationId": "runs-sync-kingly_contest_7cb-google-ads-transparency-monitor",
"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/kingly_contest_7cb~google-ads-transparency-monitor/run-sync": {
"post": {
"operationId": "run-sync-kingly_contest_7cb-google-ads-transparency-monitor",
"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": {
"mode": {
"title": "Mode",
"enum": [
"scrape",
"monitor",
"domainCheck"
],
"type": "string",
"description": "scrape: list ads. monitor: compare with the previous run and report new ads, stopped ads and new regions (schedule it). domainCheck: quick yes/no \"is this domain advertising on Google?\" for a list of domains.",
"default": "scrape"
},
"targets": {
"title": "Advertisers, domains or URLs",
"type": "array",
"description": "One per line. Accepts an advertiser ID (AR...), a domain (nike.com), an advertiser name (looked up via Google's search suggestions), or any adstransparency.google.com URL (filters in the URL override the ones below).",
"items": {
"type": "string"
}
},
"regions": {
"title": "Regions",
"type": "array",
"description": "Countries where the ads were shown. \"Anywhere\" covers all regions. Selecting several runs one search per region and records which regions each ad matched.",
"items": {
"type": "string",
"enum": [
"anywhere",
"AF",
"AX",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AI",
"AQ",
"AG",
"AR",
"AM",
"AW",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BM",
"BT",
"BO",
"BQ",
"BA",
"BW",
"BV",
"BR",
"IO",
"BN",
"BG",
"BF",
"BI",
"CV",
"KH",
"CM",
"CA",
"KY",
"CF",
"TD",
"CL",
"CN",
"CX",
"CC",
"CO",
"KM",
"CG",
"CD",
"CK",
"CR",
"CI",
"HR",
"CU",
"CW",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"SZ",
"ET",
"FK",
"FO",
"FJ",
"FI",
"FR",
"GF",
"PF",
"TF",
"GA",
"GM",
"GE",
"DE",
"GH",
"GI",
"GR",
"GL",
"GD",
"GP",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"VA",
"HN",
"HK",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IM",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KI",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MO",
"MG",
"MW",
"MY",
"MV",
"ML",
"MT",
"MH",
"MQ",
"MR",
"MU",
"YT",
"MX",
"FM",
"MD",
"MC",
"MN",
"ME",
"MS",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NL",
"NC",
"NZ",
"NI",
"NE",
"NG",
"NU",
"NF",
"KP",
"MK",
"MP",
"NO",
"OM",
"PK",
"PW",
"PS",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PL",
"PT",
"PR",
"QA",
"RE",
"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",
"SJ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TC",
"TV",
"UG",
"UA",
"AE",
"GB",
"US",
"UM",
"UY",
"UZ",
"VU",
"VE",
"VN",
"VG",
"VI",
"WF",
"EH",
"YE",
"ZM",
"ZW"
],
"enumTitles": [
"Anywhere (all regions)",
"Afghanistan (AF)",
"Åland Islands (AX)",
"Albania (AL)",
"Algeria (DZ)",
"American Samoa (AS)",
"Andorra (AD)",
"Angola (AO)",
"Anguilla (AI)",
"Antarctica (AQ)",
"Antigua and Barbuda (AG)",
"Argentina (AR)",
"Armenia (AM)",
"Aruba (AW)",
"Australia (AU)",
"Austria (AT)",
"Azerbaijan (AZ)",
"Bahamas (BS)",
"Bahrain (BH)",
"Bangladesh (BD)",
"Barbados (BB)",
"Belarus (BY)",
"Belgium (BE)",
"Belize (BZ)",
"Benin (BJ)",
"Bermuda (BM)",
"Bhutan (BT)",
"Bolivia (BO)",
"Bonaire, Sint Eustatius and Saba (BQ)",
"Bosnia and Herzegovina (BA)",
"Botswana (BW)",
"Bouvet Island (BV)",
"Brazil (BR)",
"British Indian Ocean Territory (IO)",
"Brunei Darussalam (BN)",
"Bulgaria (BG)",
"Burkina Faso (BF)",
"Burundi (BI)",
"Cabo Verde (CV)",
"Cambodia (KH)",
"Cameroon (CM)",
"Canada (CA)",
"Cayman Islands (KY)",
"Central African Republic (CF)",
"Chad (TD)",
"Chile (CL)",
"China (CN)",
"Christmas Island (CX)",
"Cocos (Keeling) Islands (CC)",
"Colombia (CO)",
"Comoros (KM)",
"Congo (CG)",
"Congo, The Democratic Republic of the (CD)",
"Cook Islands (CK)",
"Costa Rica (CR)",
"Côte d'Ivoire (CI)",
"Croatia (HR)",
"Cuba (CU)",
"Curaçao (CW)",
"Cyprus (CY)",
"Czechia (CZ)",
"Denmark (DK)",
"Djibouti (DJ)",
"Dominica (DM)",
"Dominican Republic (DO)",
"Ecuador (EC)",
"Egypt (EG)",
"El Salvador (SV)",
"Equatorial Guinea (GQ)",
"Eritrea (ER)",
"Estonia (EE)",
"Eswatini (SZ)",
"Ethiopia (ET)",
"Falkland Islands (Malvinas) (FK)",
"Faroe Islands (FO)",
"Fiji (FJ)",
"Finland (FI)",
"France (FR)",
"French Guiana (GF)",
"French Polynesia (PF)",
"French Southern Territories (TF)",
"Gabon (GA)",
"Gambia (GM)",
"Georgia (GE)",
"Germany (DE)",
"Ghana (GH)",
"Gibraltar (GI)",
"Greece (GR)",
"Greenland (GL)",
"Grenada (GD)",
"Guadeloupe (GP)",
"Guam (GU)",
"Guatemala (GT)",
"Guernsey (GG)",
"Guinea (GN)",
"Guinea-Bissau (GW)",
"Guyana (GY)",
"Haiti (HT)",
"Heard Island and McDonald Islands (HM)",
"Holy See (Vatican City State) (VA)",
"Honduras (HN)",
"Hong Kong (HK)",
"Hungary (HU)",
"Iceland (IS)",
"India (IN)",
"Indonesia (ID)",
"Iran (IR)",
"Iraq (IQ)",
"Ireland (IE)",
"Isle of Man (IM)",
"Israel (IL)",
"Italy (IT)",
"Jamaica (JM)",
"Japan (JP)",
"Jersey (JE)",
"Jordan (JO)",
"Kazakhstan (KZ)",
"Kenya (KE)",
"Kiribati (KI)",
"Kuwait (KW)",
"Kyrgyzstan (KG)",
"Laos (LA)",
"Latvia (LV)",
"Lebanon (LB)",
"Lesotho (LS)",
"Liberia (LR)",
"Libya (LY)",
"Liechtenstein (LI)",
"Lithuania (LT)",
"Luxembourg (LU)",
"Macao (MO)",
"Madagascar (MG)",
"Malawi (MW)",
"Malaysia (MY)",
"Maldives (MV)",
"Mali (ML)",
"Malta (MT)",
"Marshall Islands (MH)",
"Martinique (MQ)",
"Mauritania (MR)",
"Mauritius (MU)",
"Mayotte (YT)",
"Mexico (MX)",
"Micronesia, Federated States of (FM)",
"Moldova (MD)",
"Monaco (MC)",
"Mongolia (MN)",
"Montenegro (ME)",
"Montserrat (MS)",
"Morocco (MA)",
"Mozambique (MZ)",
"Myanmar (MM)",
"Namibia (NA)",
"Nauru (NR)",
"Nepal (NP)",
"Netherlands (NL)",
"New Caledonia (NC)",
"New Zealand (NZ)",
"Nicaragua (NI)",
"Niger (NE)",
"Nigeria (NG)",
"Niue (NU)",
"Norfolk Island (NF)",
"North Korea (KP)",
"North Macedonia (MK)",
"Northern Mariana Islands (MP)",
"Norway (NO)",
"Oman (OM)",
"Pakistan (PK)",
"Palau (PW)",
"Palestine, State of (PS)",
"Panama (PA)",
"Papua New Guinea (PG)",
"Paraguay (PY)",
"Peru (PE)",
"Philippines (PH)",
"Pitcairn (PN)",
"Poland (PL)",
"Portugal (PT)",
"Puerto Rico (PR)",
"Qatar (QA)",
"Réunion (RE)",
"Romania (RO)",
"Russian Federation (RU)",
"Rwanda (RW)",
"Saint Barthélemy (BL)",
"Saint Helena, Ascension and Tristan da Cunha (SH)",
"Saint Kitts and Nevis (KN)",
"Saint Lucia (LC)",
"Saint Martin (French part) (MF)",
"Saint Pierre and Miquelon (PM)",
"Saint Vincent and the Grenadines (VC)",
"Samoa (WS)",
"San Marino (SM)",
"Sao Tome and Principe (ST)",
"Saudi Arabia (SA)",
"Senegal (SN)",
"Serbia (RS)",
"Seychelles (SC)",
"Sierra Leone (SL)",
"Singapore (SG)",
"Sint Maarten (Dutch part) (SX)",
"Slovakia (SK)",
"Slovenia (SI)",
"Solomon Islands (SB)",
"Somalia (SO)",
"South Africa (ZA)",
"South Georgia and the South Sandwich Islands (GS)",
"South Korea (KR)",
"South Sudan (SS)",
"Spain (ES)",
"Sri Lanka (LK)",
"Sudan (SD)",
"Suriname (SR)",
"Svalbard and Jan Mayen (SJ)",
"Sweden (SE)",
"Switzerland (CH)",
"Syria (SY)",
"Taiwan (TW)",
"Tajikistan (TJ)",
"Tanzania (TZ)",
"Thailand (TH)",
"Timor-Leste (TL)",
"Togo (TG)",
"Tokelau (TK)",
"Tonga (TO)",
"Trinidad and Tobago (TT)",
"Tunisia (TN)",
"Türkiye (TR)",
"Turkmenistan (TM)",
"Turks and Caicos Islands (TC)",
"Tuvalu (TV)",
"Uganda (UG)",
"Ukraine (UA)",
"United Arab Emirates (AE)",
"United Kingdom (GB)",
"United States (US)",
"United States Minor Outlying Islands (UM)",
"Uruguay (UY)",
"Uzbekistan (UZ)",
"Vanuatu (VU)",
"Venezuela (VE)",
"Vietnam (VN)",
"Virgin Islands, British (VG)",
"Virgin Islands, U.S. (VI)",
"Wallis and Futuna (WF)",
"Western Sahara (EH)",
"Yemen (YE)",
"Zambia (ZM)",
"Zimbabwe (ZW)"
]
},
"default": [
"US"
]
},
"platforms": {
"title": "Platforms",
"type": "array",
"description": "Leave empty for all platforms. Selecting platforms runs one search per platform and labels each ad with the platforms it matched.",
"items": {
"type": "string",
"enum": [
"SEARCH",
"YOUTUBE",
"SHOPPING",
"MAPS",
"PLAY"
],
"enumTitles": [
"Google Search",
"YouTube",
"Google Shopping",
"Google Maps",
"Google Play"
]
},
"default": []
},
"formats": {
"title": "Ad formats",
"type": "array",
"description": "Leave empty for all formats.",
"items": {
"type": "string",
"enum": [
"TEXT",
"IMAGE",
"VIDEO"
],
"enumTitles": [
"Text",
"Image",
"Video"
]
},
"default": []
},
"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)."
},
"maxResultsPerTarget": {
"title": "Max ads per target",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Hard cap on ads per advertiser/domain. In monitor mode this is how many of the most recently shown ads are compared each run.",
"default": 100
},
"maxTotalResults": {
"title": "Max ads in total",
"minimum": 0,
"type": "integer",
"description": "Hard cap on ads across all targets. 0 = no overall cap.",
"default": 0
},
"fetchDetails": {
"title": "Fetch ad details",
"type": "boolean",
"description": "One extra request per ad: all variations, per-region first/last shown dates, and (EU regions only, as published by Google) impression ranges per platform. Charged as a separate ad-detail event.",
"default": false
},
"fetchPreviewContent": {
"title": "Extract video IDs and ad copy from previews",
"type": "boolean",
"description": "Downloads the ad preview script when needed to extract YouTube video IDs, image URLs and headline/description text. Recommended.",
"default": true
},
"maxAdvertisersPerName": {
"title": "Advertisers per name search",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "When a target is a name, how many matching advertiser accounts to include (best match first).",
"default": 1
},
"monitorStoreName": {
"title": "Monitor state store name",
"type": "string",
"description": "Named key-value store that remembers ads seen in previous runs. Use a different name per monitoring job if you run several.",
"default": "gads-transparency-monitor"
},
"stoppedAfterDays": {
"title": "Consider an ad stopped after (days)",
"minimum": 1,
"maximum": 365,
"type": "integer",
"description": "An ad counts as stopped when Google's \"last shown\" date is older than this.",
"default": 3
},
"alertOnFirstRun": {
"title": "Report all ads as new on the first run",
"type": "boolean",
"description": "Off: the first run only saves a baseline. On: every ad found is reported as NEW_AD.",
"default": false
},
"webhookUrl": {
"title": "Webhook URL",
"type": "string",
"description": "Optional. Receives a JSON POST with all change events at the end of each monitor run."
},
"slackWebhookUrl": {
"title": "Slack incoming webhook URL",
"type": "string",
"description": "Optional. https://hooks.slack.com/... URL; posts a short summary with links to new ads."
},
"notifyWhenNoChanges": {
"title": "Notify even when nothing changed",
"type": "boolean",
"description": "Send the webhook/Slack message on every run, not only when there are changes.",
"default": false
},
"activeWithinDays": {
"title": "Domain check: active if shown within (days)",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "Domain check marks a domain as advertising when its latest ad was shown within this many days.",
"default": 30
},
"cookies": {
"title": "Cookies (optional)",
"type": "array",
"description": "Optional Google cookies (Cookie-Editor JSON export). Not needed normally; the Actor gets fresh anonymous cookies itself."
},
"reuseSessionCookie": {
"title": "Reuse anonymous session cookie between runs",
"type": "boolean",
"description": "Saves the anonymous Google session cookie (no login, no personal data) in a key-value store named gads-transparency-session in your account for up to 12 hours, so later runs skip the warm-up request. Turn off to start every run with a fresh session.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Residential proxy strongly recommended: Google rate-limits datacenter IPs quickly.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
},
"maxRetries": {
"title": "Max retries per request",
"minimum": 0,
"maximum": 20,
"type": "integer",
"description": "On a block the Actor switches to a new IP and backs off exponentially.",
"default": 6
},
"requestDelayMs": {
"title": "Delay between requests (ms)",
"minimum": 0,
"maximum": 60000,
"type": "integer",
"description": "Base delay between API requests (plus random jitter).",
"default": 400
}
}
},
"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
}
}
}
}
}
}
}
}
}
}