{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Ads and Election Spend", "description": "Track any advertiser's Google ads. Search by advertiser name, landing page domain or advertiser ID across 244 countries and get creatives, formats, run dates and images. Election ads also return spend and impression ranges plus the age, gender and district targeting behind them.", "version": "0.0", "x-build-id": "Qr9TNLKLM26zcntuC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-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/sourabhbgp~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-sourabhbgp-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/sourabhbgp~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-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": [ "mode" ], "properties": { "mode": { "title": "What to scrape", "enum": [ "creatives", "political" ], "type": "string", "description": "Commercial ads, or election ads which additionally carry spend, impressions and audience targeting.", "default": "creatives" }, "advertiserName": { "title": "Advertiser name", "type": "string", "description": "Finds an advertiser by name, for example Nike. This matches advertiser names only. Searching the text inside ads is not supported by Google." }, "domain": { "title": "Landing page domain", "pattern": "^[a-z0-9-]+(\\.[a-z0-9-]+)+$", "type": "string", "description": "Exact domain in lowercase, for example nike.com. Returns every advertiser sending traffic to that domain, including resellers and affiliates." }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "IDs starting with AR. Several IDs are combined with OR.", "default": [], "items": { "type": "string" } }, "regions": { "title": "Countries", "type": "array", "description": "One request is sent per country, so adding countries adds runtime. Russia is not listed because Google does not publish ads there.", "items": { "type": "string", "enum": [ "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "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", "IC", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "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", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "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", "XK", "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)", "Azerbaijan (AZ)", "Bosnia and Herzegovina (BA)", "Barbados (BB)", "Bangladesh (BD)", "Belgium (BE)", "Burkina Faso (BF)", "Bulgaria (BG)", "Bahrain (BH)", "Burundi (BI)", "Benin (BJ)", "Bermuda (BM)", "Brunei (BN)", "Bolivia (BO)", "Caribbean Netherlands (BQ)", "Brazil (BR)", "The Bahamas (BS)", "Bhutan (BT)", "Bouvet Island (BV)", "Botswana (BW)", "Belarus (BY)", "Belize (BZ)", "Canada (CA)", "Cocos (Keeling) Islands (CC)", "Democratic Republic of the Congo (CD)", "Central African Republic (CF)", "Republic of the Congo (CG)", "Switzerland (CH)", "Cote d'Ivoire (CI)", "Cook Islands (CK)", "Chile (CL)", "Cameroon (CM)", "China (CN)", "Colombia (CO)", "Costa Rica (CR)", "Cabo Verde (CV)", "Curacao (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 (Islas Malvinas) (FK)", "Micronesia (FM)", "Faroe Islands (FO)", "France (FR)", "Gabon (GA)", "United Kingdom (GB)", "Grenada (GD)", "Georgia (GE)", "French Guiana (GF)", "Guernsey (GG)", "Ghana (GH)", "Gibraltar (GI)", "Greenland (GL)", "The 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)", "Canary Islands (IC)", "Indonesia (ID)", "Ireland (IE)", "Israel (IL)", "Isle of Man (IM)", "India (IN)", "British Indian Ocean Territory (IO)", "Iraq (IQ)", "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)", "South Korea (KR)", "Kuwait (KW)", "Cayman Islands (KY)", "Kazakhstan (KZ)", "Laos (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 (MD)", "Montenegro (ME)", "Saint Martin (MF)", "Madagascar (MG)", "Marshall Islands (MH)", "North Macedonia (MK)", "Mali (ML)", "Myanmar (Burma) (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 (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 Islands (PN)", "Puerto Rico (PR)", "Palestine (PS)", "Portugal (PT)", "Palau (PW)", "Paraguay (PY)", "Qatar (QA)", "Reunion (RE)", "Romania (RO)", "Serbia (RS)", "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 (SX)", "Eswatini (SZ)", "Turks and Caicos Islands (TC)", "Chad (TD)", "French Southern and Antarctic Lands (TF)", "Togo (TG)", "Thailand (TH)", "Tajikistan (TJ)", "Tokelau (TK)", "Timor-Leste (TL)", "Turkmenistan (TM)", "Tunisia (TN)", "Tonga (TO)", "Turkiye (TR)", "Trinidad and Tobago (TT)", "Tuvalu (TV)", "Taiwan (TW)", "Tanzania (TZ)", "Ukraine (UA)", "Uganda (UG)", "United States Minor Outlying Islands (UM)", "United States (US)", "Uruguay (UY)", "Uzbekistan (UZ)", "Vatican City (VA)", "Saint Vincent and the Grenadines (VC)", "Venezuela (VE)", "British Virgin Islands (VG)", "U.S. Virgin Islands (VI)", "Vietnam (VN)", "Vanuatu (VU)", "Wallis and Futuna (WF)", "Samoa (WS)", "Kosovo (XK)", "Yemen (YE)", "Mayotte (YT)", "South Africa (ZA)", "Zambia (ZM)", "Zimbabwe (ZW)" ] }, "default": [ "US" ] }, "platforms": { "title": "Google surfaces", "type": "array", "description": "Where the ad ran. One request is sent per surface. Leave empty for all surfaces.", "items": { "type": "string", "enum": [ "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Maps", "Google Play" ] }, "default": [] }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Filter by creative type. Text, image or video.", "default": "ALL" }, "startDate": { "title": "Shown after", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. Inclusive." }, "endDate": { "title": "Shown before", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "YYYY-MM-DD. This date is EXCLUSIVE: ads shown only on this day are not returned. Use the day after the last day you want." }, "maxResults": { "title": "Maximum ads", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total ads across all countries and surfaces. If you omit this field entirely, the platform uses 50.", "default": 50 }, "detailConcurrency": { "title": "Detail concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel detail lookups. 10 is the tested sweet spot.", "default": 10 }, "minSpendUsd": { "title": "Minimum spend in USD", "minimum": 0, "type": "integer", "description": "Election ads only. Keeps ads whose spend range can reach this amount. Ads in the open ended top bucket are always kept." }, "sortBy": { "title": "Sort by", "enum": [ "RECENCY", "SPEND", "IMPRESSIONS" ], "type": "string", "description": "Election ads only.", "default": "RECENCY" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Datacenter proxy is enough for this target.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }