{ "data": { "id": "QYKqbZf5c4yCTduA0", "actId": "RY95C50o6LTAaUcaH", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-10-21T16:46:59.911Z", "finishedAt": "2026-10-21T16:47:10.414Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 10377, "runTimeSecs": 10.377, "computeUnits": 0.01153, "imageSizeBytes": 354383872 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY", "exitCode": 0, "inputSchema": "{\n \"title\": \"Google Ads Transparency Center Scraper Input\",\n \"description\": \"Find ads by domain, brand, advertiser ID, or Transparency Center URL, with optional detail enrichment.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"Search individual ads, or build one row per advertiser for a domain/brand (ad-check).\",\n \"editor\": \"select\",\n \"enum\": [\n \"search\",\n \"advertisers\",\n \"byQuery\",\n \"byAdvertiserId\"\n ],\n \"enumTitles\": [\n \"Search ads\",\n \"Ad-check: one row per advertiser\",\n \"Legacy: search by query\",\n \"Legacy: search by advertiser ID\"\n ],\n \"default\": \"search\",\n \"prefill\": \"search\"\n },\n \"searchTerms\": {\n \"title\": \"Domains, brands, advertiser IDs, or URLs\",\n \"type\": \"array\",\n \"description\": \"Examples: `nike.com`, `Nike`, `AR16735076323512287233`, or an `adstransparency.google.com` URL. Brand names are resolved to the brand's website first.\",\n \"editor\": \"stringList\",\n \"prefill\": [\n \"nike.com\"\n ]\n },\n \"region\": {\n \"title\": \"Region\",\n \"type\": \"string\",\n \"description\": \"Country/market to search. `Anywhere` searches all regions.\",\n \"editor\": \"select\",\n \"enum\": [\n \"ANYWHERE\",\n \"AD\",\n \"AE\",\n \"AF\",\n \"AG\",\n \"AI\",\n \"AL\",\n \"AM\",\n \"AO\",\n \"AQ\",\n \"AR\",\n \"AS\",\n \"AT\",\n \"AU\",\n \"AW\",\n \"AX\",\n \"AZ\",\n \"BA\",\n \"BB\",\n \"BD\",\n \"BE\",\n \"BF\",\n \"BG\",\n \"BH\",\n \"BI\",\n \"BJ\",\n \"BL\",\n \"BM\",\n \"BN\",\n \"BO\",\n \"BQ\",\n \"BR\",\n \"BS\",\n \"BT\",\n \"BV\",\n \"BW\",\n \"BY\",\n \"BZ\",\n \"CA\",\n \"CC\",\n \"CD\",\n \"CF\",\n \"CG\",\n \"CH\",\n \"CI\",\n \"CK\",\n \"CL\",\n \"CM\",\n \"CN\",\n \"CO\",\n \"CR\",\n \"CU\",\n \"CV\",\n \"CW\",\n \"CX\",\n \"CY\",\n \"CZ\",\n \"DE\",\n \"DJ\",\n \"DK\",\n \"DM\",\n \"DO\",\n \"DZ\",\n \"EC\",\n \"EE\",\n \"EG\",\n \"EH\",\n \"ER\",\n \"ES\",\n \"ET\",\n \"FI\",\n \"FJ\",\n \"FK\",\n \"FM\",\n \"FO\",\n \"FR\",\n \"GA\",\n \"GB\",\n \"GD\",\n \"GE\",\n \"GF\",\n \"GG\",\n \"GH\",\n \"GI\",\n \"GL\",\n \"GM\",\n \"GN\",\n \"GP\",\n \"GQ\",\n \"GR\",\n \"GS\",\n \"GT\",\n \"GU\",\n \"GW\",\n \"GY\",\n \"HK\",\n \"HM\",\n \"HN\",\n \"HR\",\n \"HT\",\n \"HU\",\n \"ID\",\n \"IE\",\n \"IL\",\n \"IM\",\n \"IN\",\n \"IO\",\n \"IQ\",\n \"IR\",\n \"IS\",\n \"IT\",\n \"JE\",\n \"JM\",\n \"JO\",\n \"JP\",\n \"KE\",\n \"KG\",\n \"KH\",\n \"KI\",\n \"KM\",\n \"KN\",\n \"KP\",\n \"KR\",\n \"KW\",\n \"KY\",\n \"KZ\",\n \"LA\",\n \"LB\",\n \"LC\",\n \"LI\",\n \"LK\",\n \"LR\",\n \"LS\",\n \"LT\",\n \"LU\",\n \"LV\",\n \"LY\",\n \"MA\",\n \"MC\",\n \"MD\",\n \"ME\",\n \"MF\",\n \"MG\",\n \"MH\",\n \"MK\",\n \"ML\",\n \"MM\",\n \"MN\",\n \"MO\",\n \"MP\",\n \"MQ\",\n \"MR\",\n \"MS\",\n \"MT\",\n \"MU\",\n \"MV\",\n \"MW\",\n \"MX\",\n \"MY\",\n \"MZ\",\n \"NA\",\n \"NC\",\n \"NE\",\n \"NF\",\n \"NG\",\n \"NI\",\n \"NL\",\n \"NO\",\n \"NP\",\n \"NR\",\n \"NU\",\n \"NZ\",\n \"OM\",\n \"PA\",\n \"PE\",\n \"PF\",\n \"PG\",\n \"PH\",\n \"PK\",\n \"PL\",\n \"PM\",\n \"PN\",\n \"PR\",\n \"PS\",\n \"PT\",\n \"PW\",\n \"PY\",\n \"QA\",\n \"RE\",\n \"RO\",\n \"RS\",\n \"RU\",\n \"RW\",\n \"SA\",\n \"SB\",\n \"SC\",\n \"SD\",\n \"SE\",\n \"SG\",\n \"SH\",\n \"SI\",\n \"SJ\",\n \"SK\",\n \"SL\",\n \"SM\",\n \"SN\",\n \"SO\",\n \"SR\",\n \"SS\",\n \"ST\",\n \"SV\",\n \"SX\",\n \"SY\",\n \"SZ\",\n \"TC\",\n \"TD\",\n \"TF\",\n \"TG\",\n \"TH\",\n \"TJ\",\n \"TK\",\n \"TL\",\n \"TM\",\n \"TN\",\n \"TO\",\n \"TR\",\n \"TT\",\n \"TV\",\n \"TW\",\n \"TZ\",\n \"UA\",\n \"UG\",\n \"UM\",\n \"US\",\n \"UY\",\n \"UZ\",\n \"VA\",\n \"VC\",\n \"VE\",\n \"VG\",\n \"VI\",\n \"VN\",\n \"VU\",\n \"WF\",\n \"WS\",\n \"YE\",\n \"YT\",\n \"ZA\",\n \"ZM\",\n \"ZW\"\n ],\n \"enumTitles\": [\n \"Anywhere\",\n \"Andorra\",\n \"United Arab Emirates\",\n \"Afghanistan\",\n \"Antigua and Barbuda\",\n \"Anguilla\",\n \"Albania\",\n \"Armenia\",\n \"Angola\",\n \"Antarctica\",\n \"Argentina\",\n \"American Samoa\",\n \"Austria\",\n \"Australia\",\n \"Aruba\",\n \"Åland Islands\",\n \"Azerbaijan\",\n \"Bosnia and Herzegovina\",\n \"Barbados\",\n \"Bangladesh\",\n \"Belgium\",\n \"Burkina Faso\",\n \"Bulgaria\",\n \"Bahrain\",\n \"Burundi\",\n \"Benin\",\n \"Saint Barthélemy\",\n \"Bermuda\",\n \"Brunei Darussalam\",\n \"Bolivia, Plurinational State of\",\n \"Bonaire, Sint Eustatius and Saba\",\n \"Brazil\",\n \"Bahamas\",\n \"Bhutan\",\n \"Bouvet Island\",\n \"Botswana\",\n \"Belarus\",\n \"Belize\",\n \"Canada\",\n \"Cocos (Keeling) Islands\",\n \"Congo, The Democratic Republic of the\",\n \"Central African Republic\",\n \"Congo\",\n \"Switzerland\",\n \"Côte d'Ivoire\",\n \"Cook Islands\",\n \"Chile\",\n \"Cameroon\",\n \"China\",\n \"Colombia\",\n \"Costa Rica\",\n \"Cuba\",\n \"Cabo Verde\",\n \"Curaçao\",\n \"Christmas Island\",\n \"Cyprus\",\n \"Czechia\",\n \"Germany\",\n \"Djibouti\",\n \"Denmark\",\n \"Dominica\",\n \"Dominican Republic\",\n \"Algeria\",\n \"Ecuador\",\n \"Estonia\",\n \"Egypt\",\n \"Western Sahara\",\n \"Eritrea\",\n \"Spain\",\n \"Ethiopia\",\n \"Finland\",\n \"Fiji\",\n \"Falkland Islands (Malvinas)\",\n \"Micronesia, Federated States of\",\n \"Faroe Islands\",\n \"France\",\n \"Gabon\",\n \"United Kingdom\",\n \"Grenada\",\n \"Georgia\",\n \"French Guiana\",\n \"Guernsey\",\n \"Ghana\",\n \"Gibraltar\",\n \"Greenland\",\n \"Gambia\",\n \"Guinea\",\n \"Guadeloupe\",\n \"Equatorial Guinea\",\n \"Greece\",\n \"South Georgia and the South Sandwich Islands\",\n \"Guatemala\",\n \"Guam\",\n \"Guinea-Bissau\",\n \"Guyana\",\n \"Hong Kong\",\n \"Heard Island and McDonald Islands\",\n \"Honduras\",\n \"Croatia\",\n \"Haiti\",\n \"Hungary\",\n \"Indonesia\",\n \"Ireland\",\n \"Israel\",\n \"Isle of Man\",\n \"India\",\n \"British Indian Ocean Territory\",\n \"Iraq\",\n \"Iran, Islamic Republic of\",\n \"Iceland\",\n \"Italy\",\n \"Jersey\",\n \"Jamaica\",\n \"Jordan\",\n \"Japan\",\n \"Kenya\",\n \"Kyrgyzstan\",\n \"Cambodia\",\n \"Kiribati\",\n \"Comoros\",\n \"Saint Kitts and Nevis\",\n \"Korea, Democratic People's Republic of\",\n \"Korea, Republic of\",\n \"Kuwait\",\n \"Cayman Islands\",\n \"Kazakhstan\",\n \"Lao People's Democratic Republic\",\n \"Lebanon\",\n \"Saint Lucia\",\n \"Liechtenstein\",\n \"Sri Lanka\",\n \"Liberia\",\n \"Lesotho\",\n \"Lithuania\",\n \"Luxembourg\",\n \"Latvia\",\n \"Libya\",\n \"Morocco\",\n \"Monaco\",\n \"Moldova, Republic of\",\n \"Montenegro\",\n \"Saint Martin (French part)\",\n \"Madagascar\",\n \"Marshall Islands\",\n \"North Macedonia\",\n \"Mali\",\n \"Myanmar\",\n \"Mongolia\",\n \"Macao\",\n \"Northern Mariana Islands\",\n \"Martinique\",\n \"Mauritania\",\n \"Montserrat\",\n \"Malta\",\n \"Mauritius\",\n \"Maldives\",\n \"Malawi\",\n \"Mexico\",\n \"Malaysia\",\n \"Mozambique\",\n \"Namibia\",\n \"New Caledonia\",\n \"Niger\",\n \"Norfolk Island\",\n \"Nigeria\",\n \"Nicaragua\",\n \"Netherlands\",\n \"Norway\",\n \"Nepal\",\n \"Nauru\",\n \"Niue\",\n \"New Zealand\",\n \"Oman\",\n \"Panama\",\n \"Peru\",\n \"French Polynesia\",\n \"Papua New Guinea\",\n \"Philippines\",\n \"Pakistan\",\n \"Poland\",\n \"Saint Pierre and Miquelon\",\n \"Pitcairn\",\n \"Puerto Rico\",\n \"Palestine, State of\",\n \"Portugal\",\n \"Palau\",\n \"Paraguay\",\n \"Qatar\",\n \"Réunion\",\n \"Romania\",\n \"Serbia\",\n \"Russian Federation\",\n \"Rwanda\",\n \"Saudi Arabia\",\n \"Solomon Islands\",\n \"Seychelles\",\n \"Sudan\",\n \"Sweden\",\n \"Singapore\",\n \"Saint Helena, Ascension and Tristan da Cunha\",\n \"Slovenia\",\n \"Svalbard and Jan Mayen\",\n \"Slovakia\",\n \"Sierra Leone\",\n \"San Marino\",\n \"Senegal\",\n \"Somalia\",\n \"Suriname\",\n \"South Sudan\",\n \"Sao Tome and Principe\",\n \"El Salvador\",\n \"Sint Maarten (Dutch part)\",\n \"Syrian Arab Republic\",\n \"Eswatini\",\n \"Turks and Caicos Islands\",\n \"Chad\",\n \"French Southern Territories\",\n \"Togo\",\n \"Thailand\",\n \"Tajikistan\",\n \"Tokelau\",\n \"Timor-Leste\",\n \"Turkmenistan\",\n \"Tunisia\",\n \"Tonga\",\n \"Türkiye\",\n \"Trinidad and Tobago\",\n \"Tuvalu\",\n \"Taiwan, Province of China\",\n \"Tanzania, United Republic of\",\n \"Ukraine\",\n \"Uganda\",\n \"United States Minor Outlying Islands\",\n \"United States\",\n \"Uruguay\",\n \"Uzbekistan\",\n \"Holy See (Vatican City State)\",\n \"Saint Vincent and the Grenadines\",\n \"Venezuela, Bolivarian Republic of\",\n \"Virgin Islands, British\",\n \"Virgin Islands, U.S.\",\n \"Viet Nam\",\n \"Vanuatu\",\n \"Wallis and Futuna\",\n \"Samoa\",\n \"Yemen\",\n \"Mayotte\",\n \"South Africa\",\n \"Zambia\",\n \"Zimbabwe\"\n ],\n \"default\": \"US\",\n \"prefill\": \"US\"\n },\n \"adFormat\": {\n \"title\": \"Ad format\",\n \"type\": \"string\",\n \"description\": \"Restrict to one creative format.\",\n \"editor\": \"select\",\n \"enum\": [\n \"ALL\",\n \"TEXT\",\n \"IMAGE\",\n \"VIDEO\",\n \"\"\n ],\n \"enumTitles\": [\n \"All formats\",\n \"Text\",\n \"Image\",\n \"Video\",\n \"All formats (legacy)\"\n ],\n \"default\": \"ALL\",\n \"prefill\": \"ALL\"\n },\n \"platform\": {\n \"title\": \"Platform\",\n \"type\": \"string\",\n \"description\": \"Restrict to one Google surface. Platform filtering applies to ads shown from September 2023 onward.\",\n \"editor\": \"select\",\n \"enum\": [\n \"ALL\",\n \"SEARCH\",\n \"MAPS\",\n \"SHOPPING\",\n \"PLAY\",\n \"YOUTUBE\",\n \"\"\n ],\n \"enumTitles\": [\n \"All platforms\",\n \"Google Search\",\n \"Google Maps\",\n \"Google Shopping\",\n \"Google Play\",\n \"YouTube\",\n \"All platforms (legacy)\"\n ],\n \"default\": \"ALL\",\n \"prefill\": \"ALL\"\n },\n \"dateFrom\": {\n \"title\": \"Shown from (YYYY-MM-DD)\",\n \"type\": \"string\",\n \"description\": \"Only ads shown on or after this date. Leave empty for no lower bound.\",\n \"editor\": \"textfield\"\n },\n \"dateTo\": {\n \"title\": \"Shown to (YYYY-MM-DD)\",\n \"type\": \"string\",\n \"description\": \"Only ads shown on or before this date. Leave empty for no upper bound.\",\n \"editor\": \"textfield\"\n },\n \"maxItems\": {\n \"title\": \"Max records\",\n \"type\": \"integer\",\n \"description\": \"Total records to return across all search terms.\",\n \"minimum\": 1,\n \"maximum\": 100000,\n \"default\": 100,\n \"prefill\": 3\n },\n \"maxItemsPerTerm\": {\n \"title\": \"Max records per search term\",\n \"type\": \"integer\",\n \"description\": \"Optional per-term cap. Set to 0 for no per-term cap.\",\n \"minimum\": 0,\n \"maximum\": 100000,\n \"default\": 0,\n \"prefill\": 0\n },\n \"includeDetails\": {\n \"title\": \"Include full ad details\",\n \"type\": \"boolean\",\n \"description\": \"Fetch every creative's variants, per-country run dates, EU impression ranges, targeting, advertiser identity, and any available ad copy. Adds one or two requests per ad.\",\n \"default\": true,\n \"prefill\": false\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# Google Ads Transparency Creative Lookup by Domain\n\nResearch the ads a company runs through Google without a Google Ads account. Search the public [Ads Transparency Center](https://adstransparency.google.com) by landing-page domain, brand name, exact advertiser ID, or pasted URL, and export creatives with run dates, destination domains, variants, per-country activity, EU impression ranges, audience targeting, and verified advertiser identity. No login, no API key, no cookies.\n\n## What this actor does\n\n- **Search by domain, brand, advertiser ID, or URL** in one batch — paste `nike.com`, `Nike`, `AR16735076323512287233`, or a Transparency Center link\n- **Full result sets, not the first page** — follows Google's continuation cursor to the end of the result set or your chosen limit\n- **Ad details on demand** — every creative variation, per-country run dates, EU impression ranges by country and platform, audience-selection categories, and advertiser country, legal name (when published), and verification\n- **Ad-check mode** — turn a domain or brand into one row per advertiser found, with verification status and, for exact advertiser-ID lookups, Google's approximate ad-count range\n- **Filters:** 249 countries plus Anywhere, text/image/video, Search/Maps/Shopping/Play/YouTube, and a shown-during date window\n- **Empty fields are omitted** — no nulls or placeholder strings\n\n## Output per ad\n\n- `advertiserId`, `advertiserName`, `advertiserCountry`, `advertiserLegalName`, `advertiserVerified`\n- `creativeId`, `format` — `Text`, `Image`, or `Video`\n- `firstShownAt`, `lastShownAt` — Google's search-index first/last activity in ISO-8601 UTC, plus epoch timestamps; per-country dates are in `regions[]`. Direct creative URLs omit `firstShownAt` because the detail endpoint has no first-shown date\n- `daysShown` — Google's count of days the creative has been active (omitted for direct creative URLs)\n- `destinationDomain`, `destinationUrl` — where the ad clicks through to, when Google exposes it\n- `headline`, `description`, `callToAction` — when the creative stores readable copy\n- `youtubeVideoId`, `youtubeUrl`, `videoThumbnailUrl` — for video creatives\n- `previewImageUrl`, `previewWidth`, `previewHeight`, `previewContentUrl` — static image or rendered preview\n- `variationCount`, `variations[]` — every image/content variation Google returns\n- `regions[]` — per-country last-shown dates for every ad, plus first-shown dates, impression ranges, and platform breakdown where Google publishes them (mostly EU/EEA and Turkey)\n- `impressionsLow`, `impressionsHigh`, `platformsShown` — Google's EU/EEA totals; Turkey and other per-country figures are in `regions[]`. Google sometimes omits a bound, so each bound is returned only when published\n- `audienceSelection` — demographics, geographic locations, contextual signals, customer lists, and topics, each marked included/excluded\n- `creativeUrl`, `advertiserUrl`, `region`, `searchTerm`, `matchedVia`\n- `recordType: \"ad\"`, `scrapedAt`\n\n## Output per advertiser (mode = `advertisers`)\n\n- `advertiserId`, `advertiserName`, `advertiserCountry`, `advertiserLegalName`, `advertiserVerified`\n- `approxAdCountLow`, `approxAdCountHigh` — Google's stated range for exact advertiser-ID lookups; omitted for domain/brand ad-check scans, which inspect up to 500 ads\n- `scannedAds` — how many ads were inspected to find the advertisers in domain/brand ad-check mode; omitted for exact advertiser-ID lookups\n- `matchedTerm`, `matchedVia`, `matchedDomain`\n- `advertiserUrl`, `region`, `recordType: \"advertiser\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` for ad records; `advertisers` for one row per advertiser |\n| `searchTerms` | array | – | Domains, brand names, advertiser IDs, or Transparency Center URLs |\n| `region` | string | `US` | Country code or `ANYWHERE` |\n| `adFormat` | string | `ALL` | `ALL`, `TEXT`, `IMAGE`, `VIDEO` |\n| `platform` | string | `ALL` | `ALL`, `SEARCH`, `MAPS`, `SHOPPING`, `PLAY`, `YOUTUBE` |\n| `dateFrom` | string | – | Start of the shown-during window (`YYYY-MM-DD`) |\n| `dateTo` | string | – | End of the shown-during window (`YYYY-MM-DD`); an ad qualifies if it ran at any point in the window, so ads still running after this date are not excluded |\n| `maxItems` | integer | `100` | Total records to return (1–100,000) |\n| `maxItemsPerTerm` | integer | `0` | Per-term cap; 0 = no per-term cap |\n| `includeDetails` | boolean | `true` | Fetch variants, per-country reach, EU impressions, targeting, advertiser identity, and available copy |\n\n### Example: recent ads for a domain\n\n```json\n{\n \"mode\": \"search\",\n \"searchTerms\": [\"nike.com\"],\n \"region\": \"US\",\n \"maxItems\": 100,\n \"includeDetails\": true\n}\n```\n\n### Example: brand ads in Germany, video only\n\n```json\n{\n \"mode\": \"search\",\n \"searchTerms\": [\"Zalando\"],\n \"region\": \"DE\",\n \"adFormat\": \"VIDEO\",\n \"dateFrom\": \"2026-01-01\",\n \"maxItems\": 50\n}\n```\n\n### Example: exact advertiser IDs across every region\n\n```json\n{\n \"mode\": \"search\",\n \"searchTerms\": [\"AR16735076323512287233\", \"AR15589870916631265281\"],\n \"region\": \"ANYWHERE\",\n \"maxItemsPerTerm\": 200,\n \"maxItems\": 500\n}\n```\n\n### Example: ad-check a list of competitors\n\n```json\n{\n \"mode\": \"advertisers\",\n \"searchTerms\": [\"nike.com\", \"adidas.com\", \"hellofresh.com\"],\n \"region\": \"US\",\n \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **Competitive creative research** — collect a swipe file of live and recent ads, with run dates and destination pages\n- **Ad-check and lead generation** — find which advertisers send clicks to a domain, with legal names and verification badges\n- **EU reach analysis** — compare impression ranges by country and platform for DSA-covered ads\n- **Campaign longevity** — use `daysShown` and `lastShownAt` to separate long-running winners from short tests\n- **Brand safety and compliance** — verify who is paying for ads that point at your domain\n- **Market expansion** — compare a brand's creative set across countries\n\n## FAQ\n\n**Is this the official Google Ads API?** No. It reads the public Ads Transparency Center, the same data any visitor can browse, without a Google Ads account, developer project, or API key.\n\n**Do I need to paste a domain, a brand name, or an advertiser ID?** Any of the three works. Brand names are resolved to the brand's website first because Google's advertiser-name lookup often leads with small regional accounts that share the name. Use an exact `AR...` ID when you need one specific account.\n\n**Why does one domain return ads from several advertisers?** A domain search returns every ad that points at that domain, including partners, resellers, and agencies. Use `mode=advertisers` to see the accounts involved, or search an `AR...` ID to isolate one account.\n\n**Why are headline, description, or CTA missing on some ads?** Google stores many search text ads only as a picture of the ad. The actor returns readable copy when Google exposes it, and omits the field when the creative has no machine-readable text.\n\n**Why are impressions missing for some ads?** Google publishes impression ranges for some ads shown in the EU/EEA and Turkey, after a delay. Coverage is partial and varies by market and ad: some ads have run dates but no impression figures even after three months. Per-country figures are in `regions[]`; the top-level totals cover the EU/EEA only.\n\n**What does `advertiserVerified` mean?** It reflects Google's advertiser identity verification badge and is returned whenever the advertiser lookup succeeds. `false` means Google shows the advertiser as not verified.\n\n**Why is `destinationUrl` sometimes missing?** Google does not expose a landing URL on every creative. `destinationDomain` comes from the search result when you search by domain; the full URL is added when the creative preview contains it.\n\n**Can I search all countries at once?** Yes — set `region` to `ANYWHERE`. Per-ad `regions[]` then shows where each creative ran, with EU impression data where Google publishes it.\n\n**Does the actor include age-restricted ads?** No. Google requires a signed-in account to show age-restricted creatives, and this actor never uses cookies or logins.\n\n**Is this affiliated with Google?** No. It is an independent tool that reads public transparency data and is not endorsed by Google.\n", "actorDefinition": { "actorSpecification": 1, "name": "google-ads-transparency-creative-lookup-by-domain", "title": "Google Ads Transparency Creative Lookup by Domain", "description": "Find an advertiser's Google ads by domain, brand, advertiser ID, or Transparency Center URL. Get creatives, run dates, destination domains, variants, EU impressions, targeting, and verified advertiser identity.", "version": "1.0", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# Google Ads Transparency Creative Lookup by Domain\n\nResearch the ads a company runs through Google without a Google Ads account. Search the public [Ads Transparency Center](https://adstransparency.google.com) by landing-page domain, brand name, exact advertiser ID, or pasted URL, and export creatives with run dates, destination domains, variants, per-country activity, EU impression ranges, audience targeting, and verified advertiser identity. No login, no API key, no cookies.\n\n## What this actor does\n\n- **Search by domain, brand, advertiser ID, or URL** in one batch — paste `nike.com`, `Nike`, `AR16735076323512287233`, or a Transparency Center link\n- **Full result sets, not the first page** — follows Google's continuation cursor to the end of the result set or your chosen limit\n- **Ad details on demand** — every creative variation, per-country run dates, EU impression ranges by country and platform, audience-selection categories, and advertiser country, legal name (when published), and verification\n- **Ad-check mode** — turn a domain or brand into one row per advertiser found, with verification status and, for exact advertiser-ID lookups, Google's approximate ad-count range\n- **Filters:** 249 countries plus Anywhere, text/image/video, Search/Maps/Shopping/Play/YouTube, and a shown-during date window\n- **Empty fields are omitted** — no nulls or placeholder strings\n\n## Output per ad\n\n- `advertiserId`, `advertiserName`, `advertiserCountry`, `advertiserLegalName`, `advertiserVerified`\n- `creativeId`, `format` — `Text`, `Image`, or `Video`\n- `firstShownAt`, `lastShownAt` — Google's search-index first/last activity in ISO-8601 UTC, plus epoch timestamps; per-country dates are in `regions[]`. Direct creative URLs omit `firstShownAt` because the detail endpoint has no first-shown date\n- `daysShown` — Google's count of days the creative has been active (omitted for direct creative URLs)\n- `destinationDomain`, `destinationUrl` — where the ad clicks through to, when Google exposes it\n- `headline`, `description`, `callToAction` — when the creative stores readable copy\n- `youtubeVideoId`, `youtubeUrl`, `videoThumbnailUrl` — for video creatives\n- `previewImageUrl`, `previewWidth`, `previewHeight`, `previewContentUrl` — static image or rendered preview\n- `variationCount`, `variations[]` — every image/content variation Google returns\n- `regions[]` — per-country last-shown dates for every ad, plus first-shown dates, impression ranges, and platform breakdown where Google publishes them (mostly EU/EEA and Turkey)\n- `impressionsLow`, `impressionsHigh`, `platformsShown` — Google's EU/EEA totals; Turkey and other per-country figures are in `regions[]`. Google sometimes omits a bound, so each bound is returned only when published\n- `audienceSelection` — demographics, geographic locations, contextual signals, customer lists, and topics, each marked included/excluded\n- `creativeUrl`, `advertiserUrl`, `region`, `searchTerm`, `matchedVia`\n- `recordType: \"ad\"`, `scrapedAt`\n\n## Output per advertiser (mode = `advertisers`)\n\n- `advertiserId`, `advertiserName`, `advertiserCountry`, `advertiserLegalName`, `advertiserVerified`\n- `approxAdCountLow`, `approxAdCountHigh` — Google's stated range for exact advertiser-ID lookups; omitted for domain/brand ad-check scans, which inspect up to 500 ads\n- `scannedAds` — how many ads were inspected to find the advertisers in domain/brand ad-check mode; omitted for exact advertiser-ID lookups\n- `matchedTerm`, `matchedVia`, `matchedDomain`\n- `advertiserUrl`, `region`, `recordType: \"advertiser\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` for ad records; `advertisers` for one row per advertiser |\n| `searchTerms` | array | – | Domains, brand names, advertiser IDs, or Transparency Center URLs |\n| `region` | string | `US` | Country code or `ANYWHERE` |\n| `adFormat` | string | `ALL` | `ALL`, `TEXT`, `IMAGE`, `VIDEO` |\n| `platform` | string | `ALL` | `ALL`, `SEARCH`, `MAPS`, `SHOPPING`, `PLAY`, `YOUTUBE` |\n| `dateFrom` | string | – | Start of the shown-during window (`YYYY-MM-DD`) |\n| `dateTo` | string | – | End of the shown-during window (`YYYY-MM-DD`); an ad qualifies if it ran at any point in the window, so ads still running after this date are not excluded |\n| `maxItems` | integer | `100` | Total records to return (1–100,000) |\n| `maxItemsPerTerm` | integer | `0` | Per-term cap; 0 = no per-term cap |\n| `includeDetails` | boolean | `true` | Fetch variants, per-country reach, EU impressions, targeting, advertiser identity, and available copy |\n\n### Example: recent ads for a domain\n\n```json\n{\n \"mode\": \"search\",\n \"searchTerms\": [\"nike.com\"],\n \"region\": \"US\",\n \"maxItems\": 100,\n \"includeDetails\": true\n}\n```\n\n### Example: brand ads in Germany, video only\n\n```json\n{\n \"mode\": \"search\",\n \"searchTerms\": [\"Zalando\"],\n \"region\": \"DE\",\n \"adFormat\": \"VIDEO\",\n \"dateFrom\": \"2026-01-01\",\n \"maxItems\": 50\n}\n```\n\n### Example: exact advertiser IDs across every region\n\n```json\n{\n \"mode\": \"search\",\n \"searchTerms\": [\"AR16735076323512287233\", \"AR15589870916631265281\"],\n \"region\": \"ANYWHERE\",\n \"maxItemsPerTerm\": 200,\n \"maxItems\": 500\n}\n```\n\n### Example: ad-check a list of competitors\n\n```json\n{\n \"mode\": \"advertisers\",\n \"searchTerms\": [\"nike.com\", \"adidas.com\", \"hellofresh.com\"],\n \"region\": \"US\",\n \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **Competitive creative research** — collect a swipe file of live and recent ads, with run dates and destination pages\n- **Ad-check and lead generation** — find which advertisers send clicks to a domain, with legal names and verification badges\n- **EU reach analysis** — compare impression ranges by country and platform for DSA-covered ads\n- **Campaign longevity** — use `daysShown` and `lastShownAt` to separate long-running winners from short tests\n- **Brand safety and compliance** — verify who is paying for ads that point at your domain\n- **Market expansion** — compare a brand's creative set across countries\n\n## FAQ\n\n**Is this the official Google Ads API?** No. It reads the public Ads Transparency Center, the same data any visitor can browse, without a Google Ads account, developer project, or API key.\n\n**Do I need to paste a domain, a brand name, or an advertiser ID?** Any of the three works. Brand names are resolved to the brand's website first because Google's advertiser-name lookup often leads with small regional accounts that share the name. Use an exact `AR...` ID when you need one specific account.\n\n**Why does one domain return ads from several advertisers?** A domain search returns every ad that points at that domain, including partners, resellers, and agencies. Use `mode=advertisers` to see the accounts involved, or search an `AR...` ID to isolate one account.\n\n**Why are headline, description, or CTA missing on some ads?** Google stores many search text ads only as a picture of the ad. The actor returns readable copy when Google exposes it, and omits the field when the creative has no machine-readable text.\n\n**Why are impressions missing for some ads?** Google publishes impression ranges for some ads shown in the EU/EEA and Turkey, after a delay. Coverage is partial and varies by market and ad: some ads have run dates but no impression figures even after three months. Per-country figures are in `regions[]`; the top-level totals cover the EU/EEA only.\n\n**What does `advertiserVerified` mean?** It reflects Google's advertiser identity verification badge and is returned whenever the advertiser lookup succeeds. `false` means Google shows the advertiser as not verified.\n\n**Why is `destinationUrl` sometimes missing?** Google does not expose a landing URL on every creative. `destinationDomain` comes from the search result when you search by domain; the full URL is added when the creative preview contains it.\n\n**Can I search all countries at once?** Yes — set `region` to `ANYWHERE`. Per-ad `regions[]` then shows where each creative ran, with EU impression data where Google publishes it.\n\n**Does the actor include age-restricted ads?** No. Google requires a signed-in account to show age-restricted creatives, and this actor never uses cookies or logins.\n\n**Is this affiliated with Google?** No. It is an independent tool that reads public transparency data and is not endorsed by Google.\n", "input": { "title": "Google Ads Transparency Center Scraper Input", "description": "Find ads by domain, brand, advertiser ID, or Transparency Center URL, with optional detail enrichment.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "description": "Search individual ads, or build one row per advertiser for a domain/brand (ad-check).", "editor": "select", "enum": [ "search", "advertisers", "byQuery", "byAdvertiserId" ], "enumTitles": [ "Search ads", "Ad-check: one row per advertiser", "Legacy: search by query", "Legacy: search by advertiser ID" ], "default": "search", "prefill": "search" }, "searchTerms": { "title": "Domains, brands, advertiser IDs, or URLs", "type": "array", "description": "Examples: `nike.com`, `Nike`, `AR16735076323512287233`, or an `adstransparency.google.com` URL. Brand names are resolved to the brand's website first.", "editor": "stringList", "prefill": [ "nike.com" ] }, "region": { "title": "Region", "type": "string", "description": "Country/market to search. `Anywhere` searches all regions.", "editor": "select", "enum": [ "ANYWHERE", "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": [ "Anywhere", "Andorra", "United Arab Emirates", "Afghanistan", "Antigua and Barbuda", "Anguilla", "Albania", "Armenia", "Angola", "Antarctica", "Argentina", "American Samoa", "Austria", "Australia", "Aruba", "Åland Islands", "Azerbaijan", "Bosnia and Herzegovina", "Barbados", "Bangladesh", "Belgium", "Burkina Faso", "Bulgaria", "Bahrain", "Burundi", "Benin", "Saint Barthélemy", "Bermuda", "Brunei Darussalam", "Bolivia, Plurinational State of", "Bonaire, Sint Eustatius and Saba", "Brazil", "Bahamas", "Bhutan", "Bouvet Island", "Botswana", "Belarus", "Belize", "Canada", "Cocos (Keeling) Islands", "Congo, The Democratic Republic of the", "Central African Republic", "Congo", "Switzerland", "Côte d'Ivoire", "Cook Islands", "Chile", "Cameroon", "China", "Colombia", "Costa Rica", "Cuba", "Cabo Verde", "Curaçao", "Christmas Island", "Cyprus", "Czechia", "Germany", "Djibouti", "Denmark", "Dominica", "Dominican Republic", "Algeria", "Ecuador", "Estonia", "Egypt", "Western Sahara", "Eritrea", "Spain", "Ethiopia", "Finland", "Fiji", "Falkland Islands (Malvinas)", "Micronesia, Federated States of", "Faroe Islands", "France", "Gabon", "United Kingdom", "Grenada", "Georgia", "French Guiana", "Guernsey", "Ghana", "Gibraltar", "Greenland", "Gambia", "Guinea", "Guadeloupe", "Equatorial Guinea", "Greece", "South Georgia and the South Sandwich Islands", "Guatemala", "Guam", "Guinea-Bissau", "Guyana", "Hong Kong", "Heard Island and McDonald Islands", "Honduras", "Croatia", "Haiti", "Hungary", "Indonesia", "Ireland", "Israel", "Isle of Man", "India", "British Indian Ocean Territory", "Iraq", "Iran, Islamic Republic of", "Iceland", "Italy", "Jersey", "Jamaica", "Jordan", "Japan", "Kenya", "Kyrgyzstan", "Cambodia", "Kiribati", "Comoros", "Saint Kitts and Nevis", "Korea, Democratic People's Republic of", "Korea, Republic of", "Kuwait", "Cayman Islands", "Kazakhstan", "Lao People's Democratic Republic", "Lebanon", "Saint Lucia", "Liechtenstein", "Sri Lanka", "Liberia", "Lesotho", "Lithuania", "Luxembourg", "Latvia", "Libya", "Morocco", "Monaco", "Moldova, Republic of", "Montenegro", "Saint Martin (French part)", "Madagascar", "Marshall Islands", "North Macedonia", "Mali", "Myanmar", "Mongolia", "Macao", "Northern Mariana Islands", "Martinique", "Mauritania", "Montserrat", "Malta", "Mauritius", "Maldives", "Malawi", "Mexico", "Malaysia", "Mozambique", "Namibia", "New Caledonia", "Niger", "Norfolk Island", "Nigeria", "Nicaragua", "Netherlands", "Norway", "Nepal", "Nauru", "Niue", "New Zealand", "Oman", "Panama", "Peru", "French Polynesia", "Papua New Guinea", "Philippines", "Pakistan", "Poland", "Saint Pierre and Miquelon", "Pitcairn", "Puerto Rico", "Palestine, State of", "Portugal", "Palau", "Paraguay", "Qatar", "Réunion", "Romania", "Serbia", "Russian Federation", "Rwanda", "Saudi Arabia", "Solomon Islands", "Seychelles", "Sudan", "Sweden", "Singapore", "Saint Helena, Ascension and Tristan da Cunha", "Slovenia", "Svalbard and Jan Mayen", "Slovakia", "Sierra Leone", "San Marino", "Senegal", "Somalia", "Suriname", "South Sudan", "Sao Tome and Principe", "El Salvador", "Sint Maarten (Dutch part)", "Syrian Arab Republic", "Eswatini", "Turks and Caicos Islands", "Chad", "French Southern Territories", "Togo", "Thailand", "Tajikistan", "Tokelau", "Timor-Leste", "Turkmenistan", "Tunisia", "Tonga", "Türkiye", "Trinidad and Tobago", "Tuvalu", "Taiwan, Province of China", "Tanzania, United Republic of", "Ukraine", "Uganda", "United States Minor Outlying Islands", "United States", "Uruguay", "Uzbekistan", "Holy See (Vatican City State)", "Saint Vincent and the Grenadines", "Venezuela, Bolivarian Republic of", "Virgin Islands, British", "Virgin Islands, U.S.", "Viet Nam", "Vanuatu", "Wallis and Futuna", "Samoa", "Yemen", "Mayotte", "South Africa", "Zambia", "Zimbabwe" ], "default": "US", "prefill": "US" }, "adFormat": { "title": "Ad format", "type": "string", "description": "Restrict to one creative format.", "editor": "select", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO", "" ], "enumTitles": [ "All formats", "Text", "Image", "Video", "All formats (legacy)" ], "default": "ALL", "prefill": "ALL" }, "platform": { "title": "Platform", "type": "string", "description": "Restrict to one Google surface. Platform filtering applies to ads shown from September 2023 onward.", "editor": "select", "enum": [ "ALL", "SEARCH", "MAPS", "SHOPPING", "PLAY", "YOUTUBE", "" ], "enumTitles": [ "All platforms", "Google Search", "Google Maps", "Google Shopping", "Google Play", "YouTube", "All platforms (legacy)" ], "default": "ALL", "prefill": "ALL" }, "dateFrom": { "title": "Shown from (YYYY-MM-DD)", "type": "string", "description": "Only ads shown on or after this date. Leave empty for no lower bound.", "editor": "textfield" }, "dateTo": { "title": "Shown to (YYYY-MM-DD)", "type": "string", "description": "Only ads shown on or before this date. Leave empty for no upper bound.", "editor": "textfield" }, "maxItems": { "title": "Max records", "type": "integer", "description": "Total records to return across all search terms.", "minimum": 1, "maximum": 100000, "default": 100, "prefill": 3 }, "maxItemsPerTerm": { "title": "Max records per search term", "type": "integer", "description": "Optional per-term cap. Set to 0 for no per-term cap.", "minimum": 0, "maximum": 100000, "default": 0, "prefill": 0 }, "includeDetails": { "title": "Include full ad details", "type": "boolean", "description": "Fetch every creative's variants, per-country run dates, EU impression ranges, targeting, advertiser identity, and any available ad copy. Adds one or two requests per ad.", "default": true, "prefill": false } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "Google Ads Transparency Creative Lookup by Domain Output", "description": "Ad creatives and advertiser summaries from Google Ads Transparency Center: identity, formats, run dates, variants, per-country reach, EU impressions, and targeting.", "properties": { "ads": { "type": "string", "title": "Ads and advertisers", "description": "Dataset containing ad creative records and, in ad-check mode, advertiser summary records.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "Ads", "transformation": { "fields": [ "advertiserName", "format", "firstShownAt", "lastShownAt", "daysShown", "destinationDomain", "advertiserVerified", "creativeUrl" ] }, "display": { "component": "table", "properties": {} } }, "advertisers": { "title": "Advertisers", "transformation": { "fields": [ "advertiserName", "advertiserCountry", "advertiserVerified", "approxAdCountLow", "approxAdCountHigh", "matchedTerm", "scannedAds" ] }, "display": { "component": "table", "properties": {} } } } } }, "environmentVariables": {} }, "buildNumber": "1.0.2", "imageDigest": "cb6866430bb203d7fe1edd473961f15b9678903210b0545c58f807b4e0e963af", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.01153 } } }