{ "description": "Scrape Google Ads Transparency Center ads by advertiser URL or ID, domain, brand or keyword search, or a single creative.", "properties": { "advertiserId": { "description": "Google advertiser ID starting with AR (mode=advertiser or creative).", "editor": "textfield", "title": "Advertiser ID", "type": "string" }, "advertiserUrl": { "description": "Advertiser or creative URL from adstransparency.google.com (mode=advertiser or creative).", "editor": "textfield", "prefill": "https://adstransparency.google.com/advertiser/AR16735076323512287233", "title": "Advertiser URL", "type": "string" }, "creativeId": { "description": "Google creative ID starting with CR (mode=creative). Also provide advertiserId or advertiserUrl.", "editor": "textfield", "title": "Creative ID", "type": "string" }, "domain": { "description": "Domain to search across every advertiser Google links to it (mode=domain), e.g. nike.com.", "editor": "textfield", "title": "Domain", "type": "string" }, "endDate": { "description": "Client-side date filter applied to the fetched slice. Leave empty for no upper bound.", "editor": "textfield", "nullable": true, "title": "Shown on or before (YYYY-MM-DD)", "type": "string" }, "format": { "description": "Restrict to one creative format. Leave empty for all formats.", "editor": "select", "enum": [ "TEXT", "IMAGE", "VIDEO" ], "enumTitles": [ "Text", "Image", "Video" ], "nullable": true, "title": "Ad format", "type": "string" }, "includeDetails": { "default": true, "description": "Fetch per-creative detail and preview content for copy, media and region stats. Disable for a faster list-only run.", "prefill": true, "title": "Include creative details", "type": "boolean" }, "maxAdsPerAdvertiser": { "default": 20, "description": "Per-advertiser cap (1-1000). The run also stops at maxItems.", "maximum": 1000, "minimum": 1, "prefill": 1, "title": "Max ads per advertiser", "type": "integer" }, "maxItems": { "default": 50, "description": "Total ads to emit across all targets (1-1000).", "maximum": 1000, "minimum": 1, "prefill": 1, "title": "Max items", "type": "integer" }, "mode": { "default": "advertiser", "description": "Which kind of lookup to run.", "editor": "select", "enum": [ "advertiser", "domain", "search", "creative" ], "enumTitles": [ "Advertiser (URL or AR... ID)", "Domain (all advertisers linked to a domain)", "Search (brand or keyword)", "Creative (single ad URL or ID)" ], "prefill": "advertiser", "title": "Mode", "type": "string" }, "platform": { "description": "Restrict to one Google surface. Leave empty for all platforms.", "editor": "select", "enum": [ "PLAY", "MAPS", "SEARCH", "SHOPPING", "YOUTUBE" ], "enumTitles": [ "Google Play", "Google Maps", "Google Search", "Google Shopping", "YouTube" ], "nullable": true, "title": "Platform", "type": "string" }, "political": { "default": false, "description": "Return only political or issue ads. Google requires a country region for this filter.", "prefill": false, "title": "Political and issue ads only", "type": "boolean" }, "proxyConfiguration": { "default": { "useApifyProxy": true }, "description": "Optional proxy override. The actor uses an Apify automatic proxy by default.", "editor": "proxy", "prefill": { "useApifyProxy": true }, "title": "Proxy configuration", "type": "object" }, "region": { "default": "anywhere", "description": "Only return ads shown in this country. 'anywhere' applies no region filter. Required when political is enabled.", "editor": "select", "enum": [ "anywhere", "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", "KH", "CM", "CA", "CV", "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", "FM", "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", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MG", "MW", "MY", "MV", "MT", "ML", "MH", "MR", "MU", "MX", "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", "RW", "SH", "KN", "LC", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "ES", "LK", "SR", "CH", "SE", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TV", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "YE", "ZM", "ZW", "BM", "BV", "IO", "VG", "KY", "TW", "YT", "FO", "FK", "GF", "PS", "GI", "GL", "GP", "HK", "IM", "MO", "MQ", "MS", "AW", "PR", "RE", "AI", "EH", "SJ", "TC", "UM", "VI", "WF" ], "enumTitles": [ "Anywhere (no filter)", "Albania (AL)", "Algeria (DZ)", "American Samoa (AS)", "Andorra (AD)", "Angola (AO)", "Antarctica (AQ)", "Antigua and Barbuda (AG)", "Argentina (AR)", "Armenia (AM)", "Australia (AU)", "Austria (AT)", "Azerbaijan (AZ)", "Bahrain (BH)", "Bangladesh (BD)", "Barbados (BB)", "Belarus (BY)", "Belgium (BE)", "Belize (BZ)", "Benin (BJ)", "Bhutan (BT)", "Bolivia (BO)", "Bosnia and Herzegovina (BA)", "Botswana (BW)", "Brazil (BR)", "Brunei (BN)", "Bulgaria (BG)", "Burkina Faso (BF)", "Burundi (BI)", "Cambodia (KH)", "Cameroon (CM)", "Canada (CA)", "Cape Verde (CV)", "Caribbean Netherlands (BQ)", "Central African Republic (CF)", "Chad (TD)", "Chile (CL)", "China (CN)", "Christmas Island (CX)", "Cocos Islands (CC)", "Colombia (CO)", "Comoros (KM)", "Cook Islands (CK)", "Costa Rica (CR)", "Ivory Coast (CI)", "Croatia (HR)", "Curacao (CW)", "Cyprus (CY)", "Czech Republic (CZ)", "DR 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)", "Micronesia (FM)", "Fiji (FJ)", "Finland (FI)", "France (FR)", "French Polynesia (PF)", "French Southern Territories (TF)", "Gabon (GA)", "Georgia (GE)", "Germany (DE)", "Ghana (GH)", "Greece (GR)", "Grenada (GD)", "Guam (GU)", "Guatemala (GT)", "Guernsey (GG)", "Guinea (GN)", "Guinea-Bissau (GW)", "Guyana (GY)", "Haiti (HT)", "Heard Island (HM)", "Honduras (HN)", "Hungary (HU)", "Iceland (IS)", "India (IN)", "Indonesia (ID)", "Iraq (IQ)", "Ireland (IE)", "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)", "Madagascar (MG)", "Malawi (MW)", "Malaysia (MY)", "Maldives (MV)", "Malta (MT)", "Mali (ML)", "Marshall Islands (MH)", "Mauritania (MR)", "Mauritius (MU)", "Mexico (MX)", "Moldova (MD)", "Monaco (MC)", "Mongolia (MN)", "Montenegro (ME)", "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 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 (SH)", "Saint Kitts and Nevis (KN)", "Saint Lucia (LC)", "Saint Pierre and Miquelon (PM)", "Saint Vincent (VC)", "Samoa (WS)", "San Marino (SM)", "Sao Tome and Principe (ST)", "Saudi Arabia (SA)", "Senegal (SN)", "Seychelles (SC)", "Sierra Leone (SL)", "Singapore (SG)", "Sint Maarten (SX)", "Slovakia (SK)", "Slovenia (SI)", "Solomon Islands (SB)", "Somalia (SO)", "South Africa (ZA)", "South Georgia (GS)", "South Korea (KR)", "Spain (ES)", "Sri Lanka (LK)", "Suriname (SR)", "Switzerland (CH)", "Sweden (SE)", "Tajikistan (TJ)", "Tanzania (TZ)", "Thailand (TH)", "Bahamas (BS)", "Gambia (GM)", "Timor-Leste (TL)", "Togo (TG)", "Tokelau (TK)", "Tonga (TO)", "Trinidad and Tobago (TT)", "Tunisia (TN)", "Turkey (TR)", "Turkmenistan (TM)", "Tuvalu (TV)", "Uganda (UG)", "Ukraine (UA)", "United Arab Emirates (AE)", "United Kingdom (GB)", "United States (US)", "Uruguay (UY)", "Uzbekistan (UZ)", "Vanuatu (VU)", "Vatican City (VA)", "Venezuela (VE)", "Vietnam (VN)", "Yemen (YE)", "Zambia (ZM)", "Zimbabwe (ZW)", "Bermuda (BM)", "Bouvet Island (BV)", "British Indian Ocean Territory (IO)", "British Virgin Islands (VG)", "Cayman Islands (KY)", "Taiwan (TW)", "Mayotte (YT)", "Faroe Islands (FO)", "Falkland Islands (FK)", "French Guiana (GF)", "Palestine (PS)", "Gibraltar (GI)", "Greenland (GL)", "Guadeloupe (GP)", "Hong Kong (HK)", "Isle of Man (IM)", "Macau (MO)", "Martinique (MQ)", "Montserrat (MS)", "Aruba (AW)", "Puerto Rico (PR)", "Reunion (RE)", "Anguilla (AI)", "Western Sahara (EH)", "Svalbard and Jan Mayen (SJ)", "Turks and Caicos (TC)", "US Minor Outlying Islands (UM)", "US Virgin Islands (VI)", "Wallis and Futuna (WF)" ], "prefill": "anywhere", "title": "Region", "type": "string" }, "searchQuery": { "description": "Brand name or keyword resolved through Google's advertiser suggestions (mode=search).", "editor": "textfield", "title": "Search query", "type": "string" }, "startDate": { "description": "Client-side date filter applied to the fetched slice. Leave empty for no lower bound.", "editor": "textfield", "nullable": true, "title": "Shown on or after (YYYY-MM-DD)", "type": "string" }, "startUrls": { "default": [], "description": "Additional advertiser or creative URLs (mode=advertiser or creative), as {url} request-list objects.", "editor": "requestListSources", "items": { "properties": { "url": { "description": "Advertiser or creative URL from adstransparency.google.com.", "title": "URL", "type": "string" } }, "required": [ "url" ], "type": "object" }, "prefill": [], "title": "Start URLs", "type": "array" } }, "required": [ "mode" ], "schemaVersion": 1, "title": "Google Ads Transparency Scraper Input", "type": "object" }