{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper — EU reach, $1 per 1,000 ads", "description": "Every ad a company runs on Google Search, YouTube, Shopping, Maps and Play, from the Ads Transparency Center: by website, advertiser name or ID, with dates, formats, images, ad text, regions and EU reach. No login.", "version": "0.1", "x-build-id": "59A3URRh5oZ6rIM9k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/theaisololab~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-theaisololab-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/theaisololab~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-theaisololab-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/theaisololab~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-theaisololab-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", "properties": { "domains": { "title": "Websites", "type": "array", "description": "Websites whose Google ads you want (nike.com). Every advertiser that advertises this site is included. The most complete way to research a brand.", "items": { "type": "string" } }, "advertisers": { "title": "Advertiser names or IDs", "type": "array", "description": "Advertiser names as Google shows them (Nike, Inc.), advertiser IDs (AR…), or links copied from adstransparency.google.com.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Only ads shown in these countries. Leave empty for anywhere. For EU countries, details add reach (impression ranges) and audience selection.", "items": { "type": "string", "enum": [ "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW" ], "enumTitles": [ "Andorra (AD)", "United Arab Emirates (AE)", "Afghanistan (AF)", "Antigua and Barbuda (AG)", "Anguilla (AI)", "Albania (AL)", "Armenia (AM)", "Angola (AO)", "Antarctica (AQ)", "Argentina (AR)", "American Samoa (AS)", "Austria (AT)", "Australia (AU)", "Aruba (AW)", "Åland Islands (AX)", "Azerbaijan (AZ)", "Bosnia and Herzegovina (BA)", "Barbados (BB)", "Bangladesh (BD)", "Belgium (BE)", "Burkina Faso (BF)", "Bulgaria (BG)", "Bahrain (BH)", "Burundi (BI)", "Benin (BJ)", "Saint Barthélemy (BL)", "Bermuda (BM)", "Brunei Darussalam (BN)", "Bolivia, Plurinational State of (BO)", "Bonaire, Sint Eustatius and Saba (BQ)", "Brazil (BR)", "Bahamas (BS)", "Bhutan (BT)", "Bouvet Island (BV)", "Botswana (BW)", "Belarus (BY)", "Belize (BZ)", "Canada (CA)", "Cocos (Keeling) Islands (CC)", "Congo, Democratic Republic of the (CD)", "Central African Republic (CF)", "Congo (CG)", "Switzerland (CH)", "Côte d'Ivoire (CI)", "Cook Islands (CK)", "Chile (CL)", "Cameroon (CM)", "China (CN)", "Colombia (CO)", "Costa Rica (CR)", "Cuba (CU)", "Cabo Verde (CV)", "Curaçao (CW)", "Christmas Island (CX)", "Cyprus (CY)", "Czechia (CZ)", "Germany (DE)", "Djibouti (DJ)", "Denmark (DK)", "Dominica (DM)", "Dominican Republic (DO)", "Algeria (DZ)", "Ecuador (EC)", "Estonia (EE)", "Egypt (EG)", "Western Sahara (EH)", "Eritrea (ER)", "Spain (ES)", "Ethiopia (ET)", "Finland (FI)", "Fiji (FJ)", "Falkland Islands (Malvinas) (FK)", "Micronesia, Federated States of (FM)", "Faroe Islands (FO)", "France (FR)", "Gabon (GA)", "United Kingdom of Great Britain and Northern Ireland (GB)", "Grenada (GD)", "Georgia (GE)", "French Guiana (GF)", "Guernsey (GG)", "Ghana (GH)", "Gibraltar (GI)", "Greenland (GL)", "Gambia (GM)", "Guinea (GN)", "Guadeloupe (GP)", "Equatorial Guinea (GQ)", "Greece (GR)", "South Georgia and the South Sandwich Islands (GS)", "Guatemala (GT)", "Guam (GU)", "Guinea-Bissau (GW)", "Guyana (GY)", "Hong Kong (HK)", "Heard Island and McDonald Islands (HM)", "Honduras (HN)", "Croatia (HR)", "Haiti (HT)", "Hungary (HU)", "Indonesia (ID)", "Ireland (IE)", "Israel (IL)", "Isle of Man (IM)", "India (IN)", "British Indian Ocean Territory (IO)", "Iraq (IQ)", "Iran, Islamic Republic of (IR)", "Iceland (IS)", "Italy (IT)", "Jersey (JE)", "Jamaica (JM)", "Jordan (JO)", "Japan (JP)", "Kenya (KE)", "Kyrgyzstan (KG)", "Cambodia (KH)", "Kiribati (KI)", "Comoros (KM)", "Saint Kitts and Nevis (KN)", "Korea, Democratic People's Republic of (KP)", "Korea, Republic of (KR)", "Kuwait (KW)", "Cayman Islands (KY)", "Kazakhstan (KZ)", "Lao People's Democratic Republic (LA)", "Lebanon (LB)", "Saint Lucia (LC)", "Liechtenstein (LI)", "Sri Lanka (LK)", "Liberia (LR)", "Lesotho (LS)", "Lithuania (LT)", "Luxembourg (LU)", "Latvia (LV)", "Libya (LY)", "Morocco (MA)", "Monaco (MC)", "Moldova, Republic of (MD)", "Montenegro (ME)", "Saint Martin (French part) (MF)", "Madagascar (MG)", "Marshall Islands (MH)", "North Macedonia (MK)", "Mali (ML)", "Myanmar (MM)", "Mongolia (MN)", "Macao (MO)", "Northern Mariana Islands (MP)", "Martinique (MQ)", "Mauritania (MR)", "Montserrat (MS)", "Malta (MT)", "Mauritius (MU)", "Maldives (MV)", "Malawi (MW)", "Mexico (MX)", "Malaysia (MY)", "Mozambique (MZ)", "Namibia (NA)", "New Caledonia (NC)", "Niger (NE)", "Norfolk Island (NF)", "Nigeria (NG)", "Nicaragua (NI)", "Netherlands, Kingdom of the (NL)", "Norway (NO)", "Nepal (NP)", "Nauru (NR)", "Niue (NU)", "New Zealand (NZ)", "Oman (OM)", "Panama (PA)", "Peru (PE)", "French Polynesia (PF)", "Papua New Guinea (PG)", "Philippines (PH)", "Pakistan (PK)", "Poland (PL)", "Saint Pierre and Miquelon (PM)", "Pitcairn (PN)", "Puerto Rico (PR)", "Palestine, State of (PS)", "Portugal (PT)", "Palau (PW)", "Paraguay (PY)", "Qatar (QA)", "Réunion (RE)", "Romania (RO)", "Serbia (RS)", "Russian Federation (RU)", "Rwanda (RW)", "Saudi Arabia (SA)", "Solomon Islands (SB)", "Seychelles (SC)", "Sudan (SD)", "Sweden (SE)", "Singapore (SG)", "Saint Helena, Ascension and Tristan da Cunha (SH)", "Slovenia (SI)", "Svalbard and Jan Mayen (SJ)", "Slovakia (SK)", "Sierra Leone (SL)", "San Marino (SM)", "Senegal (SN)", "Somalia (SO)", "Suriname (SR)", "South Sudan (SS)", "Sao Tome and Principe (ST)", "El Salvador (SV)", "Sint Maarten (Dutch part) (SX)", "Syrian Arab Republic (SY)", "Eswatini (SZ)", "Turks and Caicos Islands (TC)", "Chad (TD)", "French Southern Territories (TF)", "Togo (TG)", "Thailand (TH)", "Tajikistan (TJ)", "Tokelau (TK)", "Timor-Leste (TL)", "Turkmenistan (TM)", "Tunisia (TN)", "Tonga (TO)", "Türkiye (TR)", "Trinidad and Tobago (TT)", "Tuvalu (TV)", "Taiwan, Province of China (TW)", "Tanzania, United Republic of (TZ)", "Ukraine (UA)", "Uganda (UG)", "United States Minor Outlying Islands (UM)", "United States of America (US)", "Uruguay (UY)", "Uzbekistan (UZ)", "Holy See (VA)", "Saint Vincent and the Grenadines (VC)", "Venezuela, Bolivarian Republic of (VE)", "Virgin Islands (British) (VG)", "Virgin Islands (U.S.) (VI)", "Viet Nam (VN)", "Vanuatu (VU)", "Wallis and Futuna (WF)", "Samoa (WS)", "Yemen (YE)", "Mayotte (YT)", "South Africa (ZA)", "Zambia (ZM)", "Zimbabwe (ZW)" ] } }, "formats": { "title": "Ad formats", "type": "array", "description": "Leave empty for all formats.", "items": { "type": "string", "enum": [ "TEXT", "IMAGE", "VIDEO" ], "enumTitles": [ "Text", "Image", "Video" ] } }, "platforms": { "title": "Google platforms", "type": "array", "description": "Leave empty for all. Google only filters by 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" ] } }, "lastDays": { "title": "Only ads shown in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "For example 30 for ads running this month. Leave empty to include older ads." }, "startDate": { "title": "Shown on or after", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only ads last shown on or after this date." }, "endDate": { "title": "Shown on or before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only ads first shown on or before this date." }, "maxAdsPerTarget": { "title": "Max ads per website/advertiser", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Newest ads first. Keeps costs predictable on huge advertisers.", "default": 100 }, "maxAdvertisersPerName": { "title": "Max advertisers per name", "minimum": 1, "maximum": 20, "type": "integer", "description": "An advertiser name can match several accounts (Nike, Inc. and Nike Retail BV). The largest ones are used first.", "default": 3 }, "includeDetails": { "title": "Include ad details", "type": "boolean", "description": "Also open each ad: regions where it ran (with dates), EU reach, topic, audience selection, variations and the ad's text when Google renders it as HTML. Slower; charged as a separate event.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google limits requests per IP; the Actor rotates proxy sessions automatically.", "default": { "useApifyProxy": true } }, "residentialFallback": { "title": "Switch to residential proxies if Google keeps blocking", "type": "boolean", "description": "Doesn't change your price.", "default": true } } }, "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 } } } } } } } } } }