{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Scraper: Competitor Ads Library",
"description": "Google Ads Transparency Center scraper: get any competitor's Google ads by domain, brand or advertiser ID with format, first/last shown dates, creative and preview URLs and per-country reach. Check if a company runs Google Ads, find advertiser IDs and monitor only new ads. Licensed data.",
"version": "1.0",
"x-build-id": "JLDeRgZUQqzDX9JTx"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vncntlabs~google-ads-transparency/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vncntlabs-google-ads-transparency",
"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/vncntlabs~google-ads-transparency/runs": {
"post": {
"operationId": "runs-sync-vncntlabs-google-ads-transparency",
"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/vncntlabs~google-ads-transparency/run-sync": {
"post": {
"operationId": "run-sync-vncntlabs-google-ads-transparency",
"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": "What do you want?",
"enum": [
"ads",
"check",
"monitor",
"advertisers"
],
"type": "string",
"description": "Ads library: every ad of each target with format, first/last shown dates, preview image/creative URLs and regions. Quick check: one row per target with hasAds, activeNow, approximate ad count and last ad date (great for lead lists). Monitor: schedule it; each run returns only ads not seen before. Find advertisers: search Google's advertiser directory by name.",
"default": "ads"
},
"targets": {
"title": "Advertisers (domains, company names, advertiser IDs or Transparency URLs)",
"type": "array",
"description": "One per line. Domain (nike.com), company name (Nike), advertiser ID (AR16735076323512287233) or an adstransparency.google.com URL. Names are matched to Google's advertiser accounts (see Advertiser name matching).",
"items": {
"type": "string"
}
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Region(s) where the ads were shown. Pick several to see per-country reach: each ad lists the selected countries it appeared in. Leave empty for all regions worldwide. Each country is a separate lookup.",
"items": {
"type": "string",
"enum": [
"US",
"GB",
"CA",
"AU",
"DE",
"FR",
"IN",
"ES",
"IT",
"NL",
"BR",
"MX",
"JP",
"AF",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AQ",
"AG",
"AR",
"AM",
"AT",
"AZ",
"BH",
"BD",
"BB",
"BE",
"BZ",
"BJ",
"BT",
"BO",
"BA",
"BW",
"BN",
"BG",
"BF",
"BI",
"CV",
"KH",
"CM",
"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",
"PF",
"TF",
"GA",
"GE",
"GH",
"GR",
"GD",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"HN",
"HK",
"HU",
"IS",
"ID",
"IQ",
"IE",
"IM",
"IL",
"JM",
"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",
"FM",
"MD",
"MC",
"MN",
"ME",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NC",
"NZ",
"NI",
"NE",
"NG",
"NU",
"NF",
"MK",
"MP",
"NO",
"OM",
"PK",
"PW",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PL",
"PT",
"QA",
"CG",
"RO",
"RW",
"SH",
"KN",
"LC",
"PM",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SL",
"SG",
"SX",
"SK",
"SI",
"SB",
"SO",
"ZA",
"GS",
"KR",
"LK",
"SR",
"SE",
"CH",
"TW",
"TJ",
"TZ",
"TH",
"BS",
"GM",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TV",
"UG",
"UA",
"AE",
"UM",
"UY",
"UZ",
"VU",
"VA",
"VE",
"VN",
"WF",
"YE",
"ZM",
"ZW"
],
"enumTitles": [
"United States (US)",
"United Kingdom (GB)",
"Canada (CA)",
"Australia (AU)",
"Germany (DE)",
"France (FR)",
"India (IN)",
"Spain (ES)",
"Italy (IT)",
"Netherlands (NL)",
"Brazil (BR)",
"Mexico (MX)",
"Japan (JP)",
"Afghanistan (AF)",
"Albania (AL)",
"Algeria (DZ)",
"American Samoa (AS)",
"Andorra (AD)",
"Angola (AO)",
"Antarctica (AQ)",
"Antigua and Barbuda (AG)",
"Argentina (AR)",
"Armenia (AM)",
"Austria (AT)",
"Azerbaijan (AZ)",
"Bahrain (BH)",
"Bangladesh (BD)",
"Barbados (BB)",
"Belgium (BE)",
"Belize (BZ)",
"Benin (BJ)",
"Bhutan (BT)",
"Bolivia (BO)",
"Bosnia and Herzegovina (BA)",
"Botswana (BW)",
"Brunei (BN)",
"Bulgaria (BG)",
"Burkina Faso (BF)",
"Burundi (BI)",
"Cabo Verde (CV)",
"Cambodia (KH)",
"Cameroon (CM)",
"Caribbean Netherlands (BQ)",
"Central African Republic (CF)",
"Chad (TD)",
"Chile (CL)",
"China (CN)",
"Christmas Island (CX)",
"Cocos (Keeling) Islands (CC)",
"Colombia (CO)",
"Comoros (KM)",
"Cook Islands (CK)",
"Costa Rica (CR)",
"Cote d'Ivoire (CI)",
"Croatia (HR)",
"Curacao (CW)",
"Cyprus (CY)",
"Czechia (CZ)",
"Democratic Republic of the Congo (CD)",
"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)",
"Fiji (FJ)",
"Finland (FI)",
"French Polynesia (PF)",
"French Southern and Antarctic Lands (TF)",
"Gabon (GA)",
"Georgia (GE)",
"Ghana (GH)",
"Greece (GR)",
"Grenada (GD)",
"Guam (GU)",
"Guatemala (GT)",
"Guernsey (GG)",
"Guinea (GN)",
"Guinea-Bissau (GW)",
"Guyana (GY)",
"Haiti (HT)",
"Heard Island and McDonald Islands (HM)",
"Honduras (HN)",
"Hong Kong (HK)",
"Hungary (HU)",
"Iceland (IS)",
"Indonesia (ID)",
"Iraq (IQ)",
"Ireland (IE)",
"Isle of Man (IM)",
"Israel (IL)",
"Jamaica (JM)",
"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)",
"Madagascar (MG)",
"Malawi (MW)",
"Malaysia (MY)",
"Maldives (MV)",
"Mali (ML)",
"Malta (MT)",
"Marshall Islands (MH)",
"Mauritania (MR)",
"Mauritius (MU)",
"Micronesia (FM)",
"Moldova (MD)",
"Monaco (MC)",
"Mongolia (MN)",
"Montenegro (ME)",
"Morocco (MA)",
"Mozambique (MZ)",
"Myanmar (Burma) (MM)",
"Namibia (NA)",
"Nauru (NR)",
"Nepal (NP)",
"New Caledonia (NC)",
"New Zealand (NZ)",
"Nicaragua (NI)",
"Niger (NE)",
"Nigeria (NG)",
"Niue (NU)",
"Norfolk Island (NF)",
"North Macedonia (MK)",
"Northern Mariana Islands (MP)",
"Norway (NO)",
"Oman (OM)",
"Pakistan (PK)",
"Palau (PW)",
"Panama (PA)",
"Papua New Guinea (PG)",
"Paraguay (PY)",
"Peru (PE)",
"Philippines (PH)",
"Pitcairn Islands (PN)",
"Poland (PL)",
"Portugal (PT)",
"Qatar (QA)",
"Republic of the Congo (CG)",
"Romania (RO)",
"Rwanda (RW)",
"Saint Helena, Ascension and Tristan da Cunha (SH)",
"Saint Kitts and Nevis (KN)",
"Saint Lucia (LC)",
"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 (SX)",
"Slovakia (SK)",
"Slovenia (SI)",
"Solomon Islands (SB)",
"Somalia (SO)",
"South Africa (ZA)",
"South Georgia and the South Sandwich Islands (GS)",
"South Korea (KR)",
"Sri Lanka (LK)",
"Suriname (SR)",
"Sweden (SE)",
"Switzerland (CH)",
"Taiwan (TW)",
"Tajikistan (TJ)",
"Tanzania (TZ)",
"Thailand (TH)",
"The Bahamas (BS)",
"The Gambia (GM)",
"Timor-Leste (TL)",
"Togo (TG)",
"Tokelau (TK)",
"Tonga (TO)",
"Trinidad and Tobago (TT)",
"Tunisia (TN)",
"Turkiye (TR)",
"Turkmenistan (TM)",
"Tuvalu (TV)",
"Uganda (UG)",
"Ukraine (UA)",
"United Arab Emirates (AE)",
"United States Minor Outlying Islands (UM)",
"Uruguay (UY)",
"Uzbekistan (UZ)",
"Vanuatu (VU)",
"Vatican City (VA)",
"Venezuela (VE)",
"Vietnam (VN)",
"Wallis and Futuna (WF)",
"Yemen (YE)",
"Zambia (ZM)",
"Zimbabwe (ZW)"
]
},
"default": [
"US"
]
},
"maxAdsPerTarget": {
"title": "Max ads per target",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Most recently shown ads first. Up to 1,000 per target; very large advertisers (e.g. 100k+ ads) return the most recent ones.",
"default": 40
},
"adFormat": {
"title": "Ad format",
"enum": [
"all",
"text",
"image",
"video"
],
"type": "string",
"description": "Only ads of this format.",
"default": "all"
},
"platform": {
"title": "Google platform",
"enum": [
"all",
"google_search",
"youtube",
"google_shopping",
"google_play",
"google_maps"
],
"type": "string",
"description": "Only ads shown on this Google platform.",
"default": "all"
},
"dateFrom": {
"title": "Shown from",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$",
"type": "string",
"description": "Only ads shown on or after this date: YYYY-MM-DD (earliest 2018-05-31) or a relative period such as '30 days' (= 30 days ago, handy for scheduled runs)."
},
"dateTo": {
"title": "Shown until",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$",
"type": "string",
"description": "Only ads shown on or before this date (YYYY-MM-DD). Defaults to today when 'Shown from' is set."
},
"activeWithinDays": {
"title": "Active means shown within (days)",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "activeNow is true when the ad (or, in quick check, the newest ad) was last shown within this many days.",
"default": 30
},
"advertiserMatch": {
"title": "Advertiser name matching",
"enum": [
"exact",
"best"
],
"type": "string",
"description": "How company names map to advertiser accounts. Exact: names equal after ignoring case, punctuation and suffixes like Inc/LLC/GmbH; all matching verified accounts are included. Best guess: falls back to the closest match. Domains and advertiser IDs are always exact.",
"default": "exact"
},
"domainAdvertisers": {
"title": "Ads found by domain",
"enum": [
"all",
"matching"
],
"type": "string",
"description": "A domain search also returns ads by other advertisers that point to that domain (partners, resellers, agencies). Every ad has advertiserMatchesTarget; choose 'matching' to keep only advertisers whose name looks like the domain owner (e.g. 'HubSpot, Inc.' for hubspot.com). Note: agencies buying ads for a brand are dropped too.",
"default": "all"
},
"includeUnverified": {
"title": "Include unverified advertisers",
"type": "boolean",
"description": "When matching names, also use advertiser accounts Google has not verified (used anyway if no verified account matches).",
"default": false
},
"maxAdvertisersPerQuery": {
"title": "Max advertisers per name (Find advertisers)",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Find advertisers mode: maximum advertiser accounts per name.",
"default": 10
},
"monitorStoreName": {
"title": "Monitor memory (key-value store name)",
"type": "string",
"description": "Monitor mode keeps the ad IDs it has seen in this named key-value store in your Apify account. Use different names for independent monitors.",
"default": "google-ads-transparency-monitor"
},
"monitorFirstRun": {
"title": "Monitor first run",
"enum": [
"return_all",
"baseline_only"
],
"type": "string",
"description": "What the very first monitor run returns for a target.",
"default": "return_all"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}