{
  "data": {
    "id": "FdFTa2mSzKP30FZG1",
    "actId": "7RSZNHchQbsOVYB4R",
    "userId": "tnBVjt3CXmcUrEE3L",
    "startedAt": "2026-11-16T00:56:26.362Z",
    "finishedAt": "2026-11-16T00:56:28.545Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 2122,
      "runTimeSecs": 2.122,
      "computeUnits": 0.0023577777777777776,
      "imageSizeBytes": 319172608
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "F2Aeb3gE2syjqz9xC",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Amazon EU Ad Repository Scraper Input\",\n  \"description\": \"Search Amazon's EU DSA ad repository by keyword or ad id, or browse restricted ads, with country, date, content-type and advertiser/payer filters.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch: keyword/browse search, exact ad-id lookup, or the restricted-ads catalogue.\",\n      \"editor\": \"select\",\n      \"sectionCaption\": \"Mode and targets\",\n      \"enum\": [\n        \"search\",\n        \"byAdIds\",\n        \"removedAds\"\n      ],\n      \"enumTitles\": [\n        \"Search by keyword or browse all\",\n        \"Look up exact ad ids\",\n        \"Browse removed/restricted ads\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"searchTerms\": {\n      \"title\": \"Search terms\",\n      \"type\": \"array\",\n      \"description\": \"Brand, advertiser, creator, product or content words (mode=search). Empty = browse all ads in the country/date window. Amazon searches ad text and advertiser names; payer names are not searchable.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"adIds\": {\n      \"title\": \"Ad ids (mode=byAdIds)\",\n      \"type\": \"array\",\n      \"description\": \"Amazon ad ids (hex or amzn1.*) or full ad-library detail URLs.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"country\": {\n      \"title\": \"Country\",\n      \"type\": \"string\",\n      \"description\": \"Only ads delivered in this country (Amazon's location filter). Use All for every EU country.\",\n      \"editor\": \"select\",\n      \"sectionCaption\": \"Market, country and dates\",\n      \"enum\": [\n        \"All\",\n        \"Belgium\",\n        \"France\",\n        \"Germany\",\n        \"Italy\",\n        \"Netherlands\",\n        \"Poland\",\n        \"Spain\",\n        \"Sweden\",\n        \"Ireland\"\n      ],\n      \"enumTitles\": [\n        \"All EU countries\",\n        \"Belgium\",\n        \"France\",\n        \"Germany\",\n        \"Italy\",\n        \"Netherlands\",\n        \"Poland\",\n        \"Spain\",\n        \"Sweden\",\n        \"Ireland\"\n      ],\n      \"default\": \"All\",\n      \"prefill\": \"Germany\"\n    },\n    \"marketplace\": {\n      \"title\": \"Marketplace host\",\n      \"type\": \"string\",\n      \"description\": \"EU storefront used for requests and detail links. All nine serve the same EU-wide repository; the Country field is the real filter.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"amazon.de\",\n        \"amazon.fr\",\n        \"amazon.it\",\n        \"amazon.es\",\n        \"amazon.nl\",\n        \"amazon.pl\",\n        \"amazon.se\",\n        \"amazon.com.be\",\n        \"amazon.ie\"\n      ],\n      \"enumTitles\": [\n        \"Amazon.de\",\n        \"Amazon.fr\",\n        \"Amazon.it\",\n        \"Amazon.es\",\n        \"Amazon.nl\",\n        \"Amazon.pl\",\n        \"Amazon.se\",\n        \"Amazon.com.be\",\n        \"Amazon.ie\"\n      ],\n      \"default\": \"amazon.de\",\n      \"prefill\": \"amazon.de\"\n    },\n    \"dateRange\": {\n      \"title\": \"Date range\",\n      \"type\": \"string\",\n      \"description\": \"Window in which the ad was delivered. Custom uses Start/End; All includes the oldest rows Amazon serves.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"last7days\",\n        \"last30days\",\n        \"last90days\",\n        \"last12months\",\n        \"custom\",\n        \"all\"\n      ],\n      \"enumTitles\": [\n        \"Last 7 days\",\n        \"Last 30 days\",\n        \"Last 90 days\",\n        \"Last 12 months\",\n        \"Custom start/end dates\",\n        \"All dates\"\n      ],\n      \"default\": \"last30days\",\n      \"prefill\": \"all\"\n    },\n    \"startDate\": {\n      \"title\": \"Start date (mode=custom)\",\n      \"type\": \"string\",\n      \"description\": \"First delivery day, YYYY-MM-DD. Only used when dateRange=custom.\",\n      \"editor\": \"textfield\"\n    },\n    \"endDate\": {\n      \"title\": \"End date (mode=custom)\",\n      \"type\": \"string\",\n      \"description\": \"Last delivery day, YYYY-MM-DD. Only used when dateRange=custom.\",\n      \"editor\": \"textfield\"\n    },\n    \"restrictedAds\": {\n      \"title\": \"Restricted ads\",\n      \"type\": \"string\",\n      \"description\": \"Exclude restricted ads, merge them after normal results, or browse only the restricted catalogue. Amazon has no text search for restricted ads.\",\n      \"editor\": \"select\",\n      \"sectionCaption\": \"Content filters\",\n      \"enum\": [\n        \"exclude\",\n        \"include\",\n        \"only\"\n      ],\n      \"enumTitles\": [\n        \"Exclude\",\n        \"Include after normal results\",\n        \"Only restricted ads\"\n      ],\n      \"default\": \"exclude\",\n      \"prefill\": \"exclude\"\n    },\n    \"contentType\": {\n      \"title\": \"Content type\",\n      \"type\": \"string\",\n      \"description\": \"All rows, sponsored ads only, or affiliate/influencer marketing content only.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"ad\",\n        \"affiliate\"\n      ],\n      \"enumTitles\": [\n        \"Ads and affiliate content\",\n        \"Sponsored ads only\",\n        \"Affiliate content only\"\n      ],\n      \"default\": \"all\",\n      \"prefill\": \"all\"\n    },\n    \"advertiserNames\": {\n      \"title\": \"Advertiser names\",\n      \"type\": \"array\",\n      \"description\": \"Keep ads whose advertiser name matches any of these (client-side; match type below). Leave empty for all.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"payerNames\": {\n      \"title\": \"Payer names\",\n      \"type\": \"array\",\n      \"description\": \"Keep ads whose payer name matches any of these (client-side). Amazon cannot search payers. Leave empty for all.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"nameMatchType\": {\n      \"title\": \"Name match type\",\n      \"type\": \"string\",\n      \"description\": \"How advertiser and payer names are compared.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"contains\",\n        \"exact\"\n      ],\n      \"enumTitles\": [\n        \"Contains\",\n        \"Exact (case/punctuation-insensitive)\"\n      ],\n      \"default\": \"contains\",\n      \"prefill\": \"contains\"\n    },\n    \"asins\": {\n      \"title\": \"ASINs\",\n      \"type\": \"array\",\n      \"description\": \"Keep ads whose landing page contains one of these ASINs or product URLs. Leave empty for all.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"mediaOnly\": {\n      \"title\": \"Only ads with creatives\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only ads that carry an image, video or audio creative.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"mediaMode\": {\n      \"title\": \"Creative media\",\n      \"type\": \"string\",\n      \"description\": \"Download: save image/video/audio files to this run's key-value store and emit public links. None: report media types only, no URLs.\",\n      \"editor\": \"select\",\n      \"sectionCaption\": \"Creative media\",\n      \"enum\": [\n        \"download\",\n        \"none\"\n      ],\n      \"enumTitles\": [\n        \"Save files to key-value store\",\n        \"No media files\"\n      ],\n      \"default\": \"download\",\n      \"prefill\": \"none\"\n    },\n    \"maxMediaMb\": {\n      \"title\": \"Max media file size (MB)\",\n      \"type\": \"integer\",\n      \"description\": \"Skip larger creative files. 0 disables media downloads.\",\n      \"minimum\": 0,\n      \"maximum\": 500,\n      \"default\": 50,\n      \"prefill\": 50\n    },\n    \"maxMediaFiles\": {\n      \"title\": \"Max media files\",\n      \"type\": \"integer\",\n      \"description\": \"Cap creative files saved in one run. 0 disables media downloads.\",\n      \"minimum\": 0,\n      \"maximum\": 1000,\n      \"default\": 100,\n      \"prefill\": 0\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted ad records for the whole run.\",\n      \"minimum\": 1,\n      \"maximum\": 10000,\n      \"sectionCaption\": \"Run limits\",\n      \"default\": 100,\n      \"prefill\": 1\n    },\n    \"maxItemsPerSearch\": {\n      \"title\": \"Max items per search term\",\n      \"type\": \"integer\",\n      \"description\": \"Cap per search term. 0 = only the global Max items cap applies.\",\n      \"minimum\": 0,\n      \"maximum\": 10000,\n      \"default\": 0,\n      \"prefill\": 0\n    },\n    \"maxPagesPerSearch\": {\n      \"title\": \"Max pages per search\",\n      \"type\": \"integer\",\n      \"description\": \"50 ads per page. Lower it to limit requests; 0 is not allowed.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 100,\n      \"prefill\": 1\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Amazon EU Ad Repository Scraper — DSA Ads, Creatives & Reach\n\nAmazon publishes a public ad repository for its European Union stores under the Digital Services Act. This actor turns that repository into structured rows: search by brand, advertiser, creator, product or content words; look up exact ad ids; or browse the restricted-ads catalogue. Every row carries the advertiser and payer, first and last delivery days, targeting methods, reach bands per country and Amazon store, landing pages, creatives and moderation details. No login, cookies, API key or proxy setup.\n\n## What this actor does\n\n- **Three modes:** keyword/browse `search`, exact `byAdIds` lookup, and `removedAds` for the compliance catalogue.\n- **Nine EU storefronts:** amazon.de, .fr, .it, .es, .nl, .pl, .se, .com.be and .ie — one EU-wide repository, with a true country filter.\n- **Advertiser, payer and ASIN filters:** keep only the names or products you care about; exact or contains matching for names.\n- **Content controls:** sponsored ads, affiliate/influencer content, or both; restricted ads excluded, merged, or only.\n- **Per-country reach:** total impressions band plus the full country/store breakdown Amazon publishes.\n- **Creatives kept alive:** image, video and audio files are saved to the run's key-value store and emitted as stable links; media types are still reported when files are skipped.\n- **Empty fields are omitted** — no `null`, blank strings or empty lists in the dataset.\n\n## Output per ad\n\nIdentity and source:\n\n- `adId`, `adUrl`, `sourceUrl` — Amazon's id and the ad's detail page\n- `type` — `AD` or `AFFILIATE_MARKETING_CONTENT`; `contentType` — `ad` or `affiliateMarketingContent`\n- `recordType: \"ad\"`, `scrapedAt`\n\nAdvertiser and timing:\n\n- `advertiserName`, `payerName`, `payerDiffers`\n- `advertisementPurpose`, `advertisementPurposes[]` — Amazon's ad text/title, split on the source separator\n- `firstShown`, `lastShown` — first/last delivery day (UTC, `YYYY-MM-DD`)\n- `daysShown`, `daysSinceLastShown`\n\nTargeting and reach:\n\n- `targetingMethods[]`, `targetingDetails[]` — method code plus a plain-language description for the known methods\n- `impressionsMin`, `impressionsMax`, `impressionsText` — total recipients band\n- `reachBySite` — Amazon's `country → {min,max}` map\n- `recipientsBreakdown[]` — `amazonSite`, `countryCode`, `{min,max}` rows\n- `countries[]`, `amazonSites[]` — sorted codes seen in the breakdown\n\nContent and creatives:\n\n- `subjectMatterUrl` — the affiliate content page when Amazon provides one\n- `landingPages[]`, `destinationUrl` — product, brand-store and other linked pages\n- `asin`, `productUrl`, `productStore`, `brandStoreUrl` — derived only from a real product/store URL\n- `creativeList[]` — `{mediaType, linkedPage, mediaUrl, mediaUrlOriginal, mediaExpiresAt, mediaSizeBytes, mediaDownloadStatus}`\n- `mediaUrls[]`, `mediaTypes[]`, `hasMedia`\n\nModeration and traceability:\n\n- `isRestricted`, `restrictionCategory`, `restrictionCategories[]`\n- `restrictionDetectionAutomated`, `illegalContentReport`\n- `marketplace`, `query`, `foundVia` — where the row came from\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `byAdIds` / `removedAds` |\n| `searchTerms` | array | `[]` | Brand, advertiser, creator, product or content words (mode=search). Empty = browse all in the window. |\n| `adIds` | array | `[]` | Amazon ad ids or detail URLs (mode=byAdIds). |\n| `country` | string | `All` | `All` or an exact country: Belgium, France, Germany, Italy, Netherlands, Poland, Spain, Sweden, Ireland. |\n| `marketplace` | string | `amazon.de` | Storefront used for requests and detail links; all nine serve the same EU dataset. |\n| `dateRange` | string | `last30days` | `last7days`, `last30days`, `last90days`, `last12months`, `custom`, `all`. |\n| `startDate` | string | – | `YYYY-MM-DD`, used with `dateRange=custom`. |\n| `endDate` | string | – | `YYYY-MM-DD`, used with `dateRange=custom`. |\n| `restrictedAds` | string | `exclude` | `exclude`, `include` (after normal results) or `only`. |\n| `contentType` | string | `all` | `all`, `ad` or `affiliate`. |\n| `advertiserNames` | array | `[]` | Keep rows whose advertiser matches any name. |\n| `payerNames` | array | `[]` | Keep rows whose payer matches any name. |\n| `nameMatchType` | string | `contains` | `contains` or `exact` (case/punctuation-insensitive). |\n| `asins` | array | `[]` | Keep rows whose landing page contains one of these ASINs or product URLs. |\n| `mediaOnly` | boolean | `false` | Keep only ads with an image, video or audio creative. |\n| `mediaMode` | string | `download` | `download` saves creatives to the key-value store; `none` reports media types only. |\n| `maxMediaMb` | integer | `50` | Skip larger creative files; `0` disables downloads. |\n| `maxMediaFiles` | integer | `100` | Cap files saved per run; `0` disables downloads. |\n| `maxItems` | integer | `100` | Hard cap on emitted rows. |\n| `maxItemsPerSearch` | integer | `0` | Cap per search term; `0` = global cap only. |\n| `maxPagesPerSearch` | integer | `100` | 50 ads per page; lower it to limit requests. |\n\n### Example: competitor watch in Germany\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchTerms\": [\"Nivea\", \"Samsung\"],\n  \"country\": \"Germany\",\n  \"dateRange\": \"last90days\",\n  \"advertiserNames\": [\"Nivea\", \"Samsung Deutschland\"],\n  \"nameMatchType\": \"contains\",\n  \"contentType\": \"ad\",\n  \"mediaMode\": \"download\",\n  \"maxItems\": 200\n}\n```\n\n### Example: affiliate and influencer content\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchTerms\": [\"beauty\", \"unboxing\"],\n  \"country\": \"All\",\n  \"dateRange\": \"last30days\",\n  \"contentType\": \"affiliate\",\n  \"maxItems\": 100\n}\n```\n\n### Example: look up known ads\n\n```json\n{\n  \"mode\": \"byAdIds\",\n  \"adIds\": [\n    \"9287036812522d737b4a187e271a412cf1a6911e\",\n    \"https://www.amazon.de/adlibrary/detail/4c16025fb8c021c28d9f1886ad719ed34657a4cb\"\n  ],\n  \"mediaMode\": \"download\",\n  \"maxItems\": 10\n}\n```\n\n### Example: removed ads for a period\n\n```json\n{\n  \"mode\": \"removedAds\",\n  \"country\": \"France\",\n  \"dateRange\": \"custom\",\n  \"startDate\": \"2026-01-01\",\n  \"endDate\": \"2026-06-30\",\n  \"maxItems\": 100\n}\n```\n\n## Use cases\n\n- **Competitive intelligence** — follow a brand's sponsored products and affiliate creators across EU stores.\n- **Retail-media research** — measure how many ads a seller runs and the reach band per country.\n- **Creative monitoring** — keep a dated archive of ad images and videos before Amazon's links expire.\n- **Compliance and DSA studies** — export removed ads with restriction categories and detection flags.\n- **Lead generation** — find active advertisers and the legal entities paying for their ads.\n- **Marketplace analytics** — join ad activity with product/ASIN data for category-level insight.\n\n## FAQ\n\n**Where does the data come from?** Amazon's public ad repository for its EU stores, published under the Digital Services Act. The actor reads the same JSON endpoints the public ad-library page uses, without an account.\n\n**Which countries are covered?** Germany, France, Italy, Spain, the Netherlands, Poland, Sweden, Belgium and Ireland. There is no US or UK ad repository.\n\n**Why does the actor ask for a marketplace if all nine return the same data?** Amazon serves one EU-wide repository from every EU store domain. The marketplace field chooses the domain used for requests and for the `adUrl` in each row; the `country` field is the real filter.\n\n**How fresh is the data?** Amazon updates the repository continuously; new ads appear after they are first shown. The actor reads it live on every run.\n\n**Why can't I search by payer name alone?** Amazon's public endpoint searches ad text and advertiser/creator names, not payer names. The actor can filter payer names on the rows it fetches, but a payer-only search needs an advertiser or product term to seed the result set.\n\n**Why do some ads have no end date, payer, reach or targeting?** Affiliate/influencer content is disclosed differently: it often has only a start date, creator and content link. Restricted ads also withhold advertiser, payer and content. Missing fields are omitted, never invented.\n\n**Why do creative links stop working after the run?** Amazon's media links are signed and expire after about 30 minutes. With `mediaMode=download` the actor saves the file to the run's key-value store and emits a stable link, keeping the signed source as `mediaUrlOriginal` for traceability. With `mediaMode=none` it reports only `hasMedia` and `mediaTypes`.\n\n**Why are some ads missing from a search?** Amazon's search is relevance-ranked and full-text over ad titles and advertiser names. A brand can appear in another seller's product text; use `advertiserNames` with `exact` for only the brand's own rows. Very broad terms can be deep, so set `maxItems` and `maxPagesPerSearch`.\n\n**Can I get a bulk CSV from Amazon?** No. Amazon's public repository has no bulk export endpoint; this actor pages through the same 50-row pages and gives you a dataset you can export as CSV, Excel or JSON from Apify.\n\n**Do I need a proxy or cookies?** No. The actor reads the public repository directly and chooses a working EU storefront automatically.\n\n**Is this affiliated with Amazon?** No. It is a third-party tool that reads Amazon's public transparency data. You are responsible for how you use the data.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "amazon-ad-library",
      "title": "Amazon EU Ad Repository Scraper — DSA Ads, Creatives & Reach",
      "description": "Query Amazon's EU Digital Services Act ad repository across nine storefronts: keyword or ad-id lookup, restricted-ad browse, advertiser and payer filters, per-country reach bands and creatives saved to storage.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Amazon EU Ad Repository Scraper — DSA Ads, Creatives & Reach\n\nAmazon publishes a public ad repository for its European Union stores under the Digital Services Act. This actor turns that repository into structured rows: search by brand, advertiser, creator, product or content words; look up exact ad ids; or browse the restricted-ads catalogue. Every row carries the advertiser and payer, first and last delivery days, targeting methods, reach bands per country and Amazon store, landing pages, creatives and moderation details. No login, cookies, API key or proxy setup.\n\n## What this actor does\n\n- **Three modes:** keyword/browse `search`, exact `byAdIds` lookup, and `removedAds` for the compliance catalogue.\n- **Nine EU storefronts:** amazon.de, .fr, .it, .es, .nl, .pl, .se, .com.be and .ie — one EU-wide repository, with a true country filter.\n- **Advertiser, payer and ASIN filters:** keep only the names or products you care about; exact or contains matching for names.\n- **Content controls:** sponsored ads, affiliate/influencer content, or both; restricted ads excluded, merged, or only.\n- **Per-country reach:** total impressions band plus the full country/store breakdown Amazon publishes.\n- **Creatives kept alive:** image, video and audio files are saved to the run's key-value store and emitted as stable links; media types are still reported when files are skipped.\n- **Empty fields are omitted** — no `null`, blank strings or empty lists in the dataset.\n\n## Output per ad\n\nIdentity and source:\n\n- `adId`, `adUrl`, `sourceUrl` — Amazon's id and the ad's detail page\n- `type` — `AD` or `AFFILIATE_MARKETING_CONTENT`; `contentType` — `ad` or `affiliateMarketingContent`\n- `recordType: \"ad\"`, `scrapedAt`\n\nAdvertiser and timing:\n\n- `advertiserName`, `payerName`, `payerDiffers`\n- `advertisementPurpose`, `advertisementPurposes[]` — Amazon's ad text/title, split on the source separator\n- `firstShown`, `lastShown` — first/last delivery day (UTC, `YYYY-MM-DD`)\n- `daysShown`, `daysSinceLastShown`\n\nTargeting and reach:\n\n- `targetingMethods[]`, `targetingDetails[]` — method code plus a plain-language description for the known methods\n- `impressionsMin`, `impressionsMax`, `impressionsText` — total recipients band\n- `reachBySite` — Amazon's `country → {min,max}` map\n- `recipientsBreakdown[]` — `amazonSite`, `countryCode`, `{min,max}` rows\n- `countries[]`, `amazonSites[]` — sorted codes seen in the breakdown\n\nContent and creatives:\n\n- `subjectMatterUrl` — the affiliate content page when Amazon provides one\n- `landingPages[]`, `destinationUrl` — product, brand-store and other linked pages\n- `asin`, `productUrl`, `productStore`, `brandStoreUrl` — derived only from a real product/store URL\n- `creativeList[]` — `{mediaType, linkedPage, mediaUrl, mediaUrlOriginal, mediaExpiresAt, mediaSizeBytes, mediaDownloadStatus}`\n- `mediaUrls[]`, `mediaTypes[]`, `hasMedia`\n\nModeration and traceability:\n\n- `isRestricted`, `restrictionCategory`, `restrictionCategories[]`\n- `restrictionDetectionAutomated`, `illegalContentReport`\n- `marketplace`, `query`, `foundVia` — where the row came from\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `byAdIds` / `removedAds` |\n| `searchTerms` | array | `[]` | Brand, advertiser, creator, product or content words (mode=search). Empty = browse all in the window. |\n| `adIds` | array | `[]` | Amazon ad ids or detail URLs (mode=byAdIds). |\n| `country` | string | `All` | `All` or an exact country: Belgium, France, Germany, Italy, Netherlands, Poland, Spain, Sweden, Ireland. |\n| `marketplace` | string | `amazon.de` | Storefront used for requests and detail links; all nine serve the same EU dataset. |\n| `dateRange` | string | `last30days` | `last7days`, `last30days`, `last90days`, `last12months`, `custom`, `all`. |\n| `startDate` | string | – | `YYYY-MM-DD`, used with `dateRange=custom`. |\n| `endDate` | string | – | `YYYY-MM-DD`, used with `dateRange=custom`. |\n| `restrictedAds` | string | `exclude` | `exclude`, `include` (after normal results) or `only`. |\n| `contentType` | string | `all` | `all`, `ad` or `affiliate`. |\n| `advertiserNames` | array | `[]` | Keep rows whose advertiser matches any name. |\n| `payerNames` | array | `[]` | Keep rows whose payer matches any name. |\n| `nameMatchType` | string | `contains` | `contains` or `exact` (case/punctuation-insensitive). |\n| `asins` | array | `[]` | Keep rows whose landing page contains one of these ASINs or product URLs. |\n| `mediaOnly` | boolean | `false` | Keep only ads with an image, video or audio creative. |\n| `mediaMode` | string | `download` | `download` saves creatives to the key-value store; `none` reports media types only. |\n| `maxMediaMb` | integer | `50` | Skip larger creative files; `0` disables downloads. |\n| `maxMediaFiles` | integer | `100` | Cap files saved per run; `0` disables downloads. |\n| `maxItems` | integer | `100` | Hard cap on emitted rows. |\n| `maxItemsPerSearch` | integer | `0` | Cap per search term; `0` = global cap only. |\n| `maxPagesPerSearch` | integer | `100` | 50 ads per page; lower it to limit requests. |\n\n### Example: competitor watch in Germany\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchTerms\": [\"Nivea\", \"Samsung\"],\n  \"country\": \"Germany\",\n  \"dateRange\": \"last90days\",\n  \"advertiserNames\": [\"Nivea\", \"Samsung Deutschland\"],\n  \"nameMatchType\": \"contains\",\n  \"contentType\": \"ad\",\n  \"mediaMode\": \"download\",\n  \"maxItems\": 200\n}\n```\n\n### Example: affiliate and influencer content\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchTerms\": [\"beauty\", \"unboxing\"],\n  \"country\": \"All\",\n  \"dateRange\": \"last30days\",\n  \"contentType\": \"affiliate\",\n  \"maxItems\": 100\n}\n```\n\n### Example: look up known ads\n\n```json\n{\n  \"mode\": \"byAdIds\",\n  \"adIds\": [\n    \"9287036812522d737b4a187e271a412cf1a6911e\",\n    \"https://www.amazon.de/adlibrary/detail/4c16025fb8c021c28d9f1886ad719ed34657a4cb\"\n  ],\n  \"mediaMode\": \"download\",\n  \"maxItems\": 10\n}\n```\n\n### Example: removed ads for a period\n\n```json\n{\n  \"mode\": \"removedAds\",\n  \"country\": \"France\",\n  \"dateRange\": \"custom\",\n  \"startDate\": \"2026-01-01\",\n  \"endDate\": \"2026-06-30\",\n  \"maxItems\": 100\n}\n```\n\n## Use cases\n\n- **Competitive intelligence** — follow a brand's sponsored products and affiliate creators across EU stores.\n- **Retail-media research** — measure how many ads a seller runs and the reach band per country.\n- **Creative monitoring** — keep a dated archive of ad images and videos before Amazon's links expire.\n- **Compliance and DSA studies** — export removed ads with restriction categories and detection flags.\n- **Lead generation** — find active advertisers and the legal entities paying for their ads.\n- **Marketplace analytics** — join ad activity with product/ASIN data for category-level insight.\n\n## FAQ\n\n**Where does the data come from?** Amazon's public ad repository for its EU stores, published under the Digital Services Act. The actor reads the same JSON endpoints the public ad-library page uses, without an account.\n\n**Which countries are covered?** Germany, France, Italy, Spain, the Netherlands, Poland, Sweden, Belgium and Ireland. There is no US or UK ad repository.\n\n**Why does the actor ask for a marketplace if all nine return the same data?** Amazon serves one EU-wide repository from every EU store domain. The marketplace field chooses the domain used for requests and for the `adUrl` in each row; the `country` field is the real filter.\n\n**How fresh is the data?** Amazon updates the repository continuously; new ads appear after they are first shown. The actor reads it live on every run.\n\n**Why can't I search by payer name alone?** Amazon's public endpoint searches ad text and advertiser/creator names, not payer names. The actor can filter payer names on the rows it fetches, but a payer-only search needs an advertiser or product term to seed the result set.\n\n**Why do some ads have no end date, payer, reach or targeting?** Affiliate/influencer content is disclosed differently: it often has only a start date, creator and content link. Restricted ads also withhold advertiser, payer and content. Missing fields are omitted, never invented.\n\n**Why do creative links stop working after the run?** Amazon's media links are signed and expire after about 30 minutes. With `mediaMode=download` the actor saves the file to the run's key-value store and emits a stable link, keeping the signed source as `mediaUrlOriginal` for traceability. With `mediaMode=none` it reports only `hasMedia` and `mediaTypes`.\n\n**Why are some ads missing from a search?** Amazon's search is relevance-ranked and full-text over ad titles and advertiser names. A brand can appear in another seller's product text; use `advertiserNames` with `exact` for only the brand's own rows. Very broad terms can be deep, so set `maxItems` and `maxPagesPerSearch`.\n\n**Can I get a bulk CSV from Amazon?** No. Amazon's public repository has no bulk export endpoint; this actor pages through the same 50-row pages and gives you a dataset you can export as CSV, Excel or JSON from Apify.\n\n**Do I need a proxy or cookies?** No. The actor reads the public repository directly and chooses a working EU storefront automatically.\n\n**Is this affiliated with Amazon?** No. It is a third-party tool that reads Amazon's public transparency data. You are responsible for how you use the data.\n",
      "input": {
        "title": "Amazon EU Ad Repository Scraper Input",
        "description": "Search Amazon's EU DSA ad repository by keyword or ad id, or browse restricted ads, with country, date, content-type and advertiser/payer filters.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch: keyword/browse search, exact ad-id lookup, or the restricted-ads catalogue.",
            "editor": "select",
            "sectionCaption": "Mode and targets",
            "enum": [
              "search",
              "byAdIds",
              "removedAds"
            ],
            "enumTitles": [
              "Search by keyword or browse all",
              "Look up exact ad ids",
              "Browse removed/restricted ads"
            ],
            "default": "search",
            "prefill": "search"
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Brand, advertiser, creator, product or content words (mode=search). Empty = browse all ads in the country/date window. Amazon searches ad text and advertiser names; payer names are not searchable.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "adIds": {
            "title": "Ad ids (mode=byAdIds)",
            "type": "array",
            "description": "Amazon ad ids (hex or amzn1.*) or full ad-library detail URLs.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Only ads delivered in this country (Amazon's location filter). Use All for every EU country.",
            "editor": "select",
            "sectionCaption": "Market, country and dates",
            "enum": [
              "All",
              "Belgium",
              "France",
              "Germany",
              "Italy",
              "Netherlands",
              "Poland",
              "Spain",
              "Sweden",
              "Ireland"
            ],
            "enumTitles": [
              "All EU countries",
              "Belgium",
              "France",
              "Germany",
              "Italy",
              "Netherlands",
              "Poland",
              "Spain",
              "Sweden",
              "Ireland"
            ],
            "default": "All",
            "prefill": "Germany"
          },
          "marketplace": {
            "title": "Marketplace host",
            "type": "string",
            "description": "EU storefront used for requests and detail links. All nine serve the same EU-wide repository; the Country field is the real filter.",
            "editor": "select",
            "enum": [
              "amazon.de",
              "amazon.fr",
              "amazon.it",
              "amazon.es",
              "amazon.nl",
              "amazon.pl",
              "amazon.se",
              "amazon.com.be",
              "amazon.ie"
            ],
            "enumTitles": [
              "Amazon.de",
              "Amazon.fr",
              "Amazon.it",
              "Amazon.es",
              "Amazon.nl",
              "Amazon.pl",
              "Amazon.se",
              "Amazon.com.be",
              "Amazon.ie"
            ],
            "default": "amazon.de",
            "prefill": "amazon.de"
          },
          "dateRange": {
            "title": "Date range",
            "type": "string",
            "description": "Window in which the ad was delivered. Custom uses Start/End; All includes the oldest rows Amazon serves.",
            "editor": "select",
            "enum": [
              "last7days",
              "last30days",
              "last90days",
              "last12months",
              "custom",
              "all"
            ],
            "enumTitles": [
              "Last 7 days",
              "Last 30 days",
              "Last 90 days",
              "Last 12 months",
              "Custom start/end dates",
              "All dates"
            ],
            "default": "last30days",
            "prefill": "all"
          },
          "startDate": {
            "title": "Start date (mode=custom)",
            "type": "string",
            "description": "First delivery day, YYYY-MM-DD. Only used when dateRange=custom.",
            "editor": "textfield"
          },
          "endDate": {
            "title": "End date (mode=custom)",
            "type": "string",
            "description": "Last delivery day, YYYY-MM-DD. Only used when dateRange=custom.",
            "editor": "textfield"
          },
          "restrictedAds": {
            "title": "Restricted ads",
            "type": "string",
            "description": "Exclude restricted ads, merge them after normal results, or browse only the restricted catalogue. Amazon has no text search for restricted ads.",
            "editor": "select",
            "sectionCaption": "Content filters",
            "enum": [
              "exclude",
              "include",
              "only"
            ],
            "enumTitles": [
              "Exclude",
              "Include after normal results",
              "Only restricted ads"
            ],
            "default": "exclude",
            "prefill": "exclude"
          },
          "contentType": {
            "title": "Content type",
            "type": "string",
            "description": "All rows, sponsored ads only, or affiliate/influencer marketing content only.",
            "editor": "select",
            "enum": [
              "all",
              "ad",
              "affiliate"
            ],
            "enumTitles": [
              "Ads and affiliate content",
              "Sponsored ads only",
              "Affiliate content only"
            ],
            "default": "all",
            "prefill": "all"
          },
          "advertiserNames": {
            "title": "Advertiser names",
            "type": "array",
            "description": "Keep ads whose advertiser name matches any of these (client-side; match type below). Leave empty for all.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "payerNames": {
            "title": "Payer names",
            "type": "array",
            "description": "Keep ads whose payer name matches any of these (client-side). Amazon cannot search payers. Leave empty for all.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "nameMatchType": {
            "title": "Name match type",
            "type": "string",
            "description": "How advertiser and payer names are compared.",
            "editor": "select",
            "enum": [
              "contains",
              "exact"
            ],
            "enumTitles": [
              "Contains",
              "Exact (case/punctuation-insensitive)"
            ],
            "default": "contains",
            "prefill": "contains"
          },
          "asins": {
            "title": "ASINs",
            "type": "array",
            "description": "Keep ads whose landing page contains one of these ASINs or product URLs. Leave empty for all.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "mediaOnly": {
            "title": "Only ads with creatives",
            "type": "boolean",
            "description": "Keep only ads that carry an image, video or audio creative.",
            "default": false,
            "prefill": false
          },
          "mediaMode": {
            "title": "Creative media",
            "type": "string",
            "description": "Download: save image/video/audio files to this run's key-value store and emit public links. None: report media types only, no URLs.",
            "editor": "select",
            "sectionCaption": "Creative media",
            "enum": [
              "download",
              "none"
            ],
            "enumTitles": [
              "Save files to key-value store",
              "No media files"
            ],
            "default": "download",
            "prefill": "none"
          },
          "maxMediaMb": {
            "title": "Max media file size (MB)",
            "type": "integer",
            "description": "Skip larger creative files. 0 disables media downloads.",
            "minimum": 0,
            "maximum": 500,
            "default": 50,
            "prefill": 50
          },
          "maxMediaFiles": {
            "title": "Max media files",
            "type": "integer",
            "description": "Cap creative files saved in one run. 0 disables media downloads.",
            "minimum": 0,
            "maximum": 1000,
            "default": 100,
            "prefill": 0
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted ad records for the whole run.",
            "minimum": 1,
            "maximum": 10000,
            "sectionCaption": "Run limits",
            "default": 100,
            "prefill": 1
          },
          "maxItemsPerSearch": {
            "title": "Max items per search term",
            "type": "integer",
            "description": "Cap per search term. 0 = only the global Max items cap applies.",
            "minimum": 0,
            "maximum": 10000,
            "default": 0,
            "prefill": 0
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "type": "integer",
            "description": "50 ads per page. Lower it to limit requests; 0 is not allowed.",
            "minimum": 1,
            "maximum": 1000,
            "default": 100,
            "prefill": 1
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Amazon EU Ad Repository Scraper Output",
        "description": "Ads and affiliate marketing content from Amazon's EU DSA ad repository — advertiser, payer, delivery dates, per-country reach bands, targeting methods, creatives and restriction details.",
        "properties": {
          "ads": {
            "type": "string",
            "title": "Amazon EU ads",
            "description": "Dataset containing every scraped Amazon EU ad or affiliate content record.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "categories": [
        "MARKETING",
        "E_COMMERCE"
      ],
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Amazon EU ads",
              "transformation": {
                "fields": [
                  "adId",
                  "advertiserName",
                  "advertisementPurpose",
                  "type",
                  "firstShown",
                  "impressionsText"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "05878a1ca44a3bd5286755d47cc47acedb29d09645c9f6607bfd9752e40bbd13",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0023577777777777776
    }
  }
}