# Amazon Ad Library Scraper (`aboo.script/amazon-ads-scraper`) Actor

\[💰$2 / 1K] ⚡ Fast Amazon Ad Library scraper. No login, no API key. Search EU ads by keyword or paste library, removed-ads or ad URLs from 9 Amazon EU stores, filter by country and date. Get advertiser, payer, product ASIN, creatives, impressions per country and targeting.

- **URL**: https://apify.com/aboo.script/amazon-ads-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Amazon Ad Library Scraper

![Amazon Ad Library Scraper](https://i.ibb.co/Mk7MY7J7/amazon-ads-banner.png)

**Amazon Ad Library Scraper** extracts ads and affiliate marketing content from the [Amazon Ad Library](https://www.amazon.de/adlibrary) of Amazon's EU stores into clean, structured data you can download as JSON, CSV, Excel, or HTML. Type a brand, advertiser, or product name, or paste an Ad Library URL, and get the advertiser, who paid, the advertised product and ASIN, the ad creative, the dates it ran, impressions per country, and audience targeting for every ad. No account or login required.

### Introduction

The [Amazon Ad Library](https://www.amazon.de/adlibrary) is Amazon's public ad repository for its European stores (Germany, France, Italy, Spain, the Netherlands, Poland, Sweden, Belgium, and Ireland). It lists the ads and affiliate marketing content shown on the Amazon store within the past year, with who advertised, who paid, how many people saw each ad in each country, and how the audience was targeted. It also lists ads that were removed for compliance issues.

This Amazon ad library scraper collects the same public information you see in your browser and turns it into a ready-to-use dataset. Search many brands at once, filter by country and date, run it once or on a schedule, and connect the results to your own tools.

### What data can you extract from the Amazon Ad Library?

- 🏢 Advertiser name and the company that paid for the ad
- 🏷️ Ad type (ad or affiliate marketing content) and what the ad is about
- 📦 Advertised product: ASIN, product link, and brand store page
- 🖼️ Ad creatives: image or video link and the page the ad links to
- 🎬 Affiliate content page for creator videos
- 📅 First and last day the ad was shown
- 👀 Impressions range in total and per country
- 🎯 Targeting methods (location, past activity, search terms, ads preferences)
- 🚫 Compliance details for removed ads: restriction categories, automated detection, illegal content report
- 🔗 Direct link to each ad in the Ad Library

### Use Cases

- 📈 **Market research**: see which brands advertise most on Amazon in each EU country and which products they push.
- 🕵️ **Competitor monitoring**: follow your competitors' Amazon ads, products, creatives, and reach over time.
- 🤝 **Lead generation**: find active Amazon advertisers and the companies paying for their ads.
- 🗂️ **Database building**: build your own searchable archive of Amazon ads and creatives.
- ⚖️ **Compliance and research**: study removed ads and their restriction categories under the EU Digital Services Act.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape the Amazon Ad Library step by step

1. Paste one or more Amazon Ad Library URLs into **Start URLs**, or type brand, advertiser, or product names into **Search queries**.
2. Optionally pick a **Country** and a date range with **Shown from** and **Shown until** for your search queries.
3. Set **Maximum number of results** to how many ads you want per URL or per query.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Amazon Ad Library URLs from any EU store (amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.pl, amazon.se, amazon.com.be, amazon.ie). Supported pages: search result pages (the keyword, dates, and country in the URL are kept), the compliance search page for removed ads, and single ad detail pages.
- **Search queries**: keywords to search in the Ad Library, such as a brand, advertiser, or product name, one per line. Each query is scraped separately.
- **Country**: only ads shown in this country. Applies to search queries.
- **Shown from**: only ads shown on or after this date. Applies to search queries.
- **Shown until**: only ads shown on or before this date. Applies to search queries.
- **Maximum number of results**: how many ads to collect for each start URL or search query. Set 0 for no limit.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape an Ad Library search page:

```json
{
  "startUrls": [
    { "url": "https://www.amazon.de/adlibrary/list?searchString=lego&location=Germany" }
  ],
  "maxResults": 5
}
```

Search by keywords:

```json
{
  "searchQueries": ["nivea"],
  "country": "All",
  "maxResults": 5
}
```

Search by keyword in one country and date range:

```json
{
  "searchQueries": ["samsung tv"],
  "country": "Spain",
  "startDate": "2026-01-01",
  "endDate": "2026-06-30",
  "maxResults": 5
}
```

### Output

Each ad is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://www.amazon.de/adlibrary/detail/a33562bb4e77dfecf0e784adf2aa0aad5deabb12",
  "id": "a33562bb4e77dfecf0e784adf2aa0aad5deabb12",
  "type": "Ad",
  "advertiserName": "Legology",
  "payerName": "Legology Limited",
  "adAbout": [
    "Legology Exfoliating Mitt Buff Lite für Tiefenreinigung, Lymphdrainage und Hautvorbereitung – Doppelseitiges Duschpad für Po und Hüften"
  ],
  "asin": "B0B7SMCZC3",
  "productUrl": "https://www.amazon.de/dp/B0B7SMCZC3",
  "storePageUrl": null,
  "contentUrl": null,
  "creatives": [
    {
      "mediaType": null,
      "mediaUrl": null,
      "linkedUrl": "https://www.amazon.de/dp/B0B7SMCZC3",
      "asin": "B0B7SMCZC3"
    }
  ],
  "firstShown": "2023-08-19T00:00:00Z",
  "lastShown": "2026-01-05T00:00:00Z",
  "impressionsMin": 379000,
  "impressionsMax": 380000,
  "impressionsByCountry": [
    {
      "country": "Germany",
      "countryCode": "DE",
      "impressionsMin": 379000,
      "impressionsMax": 380000
    }
  ],
  "targetingMethods": ["Location", "Past activity", "Search terms"],
  "removedForCompliance": false,
  "restrictionCategories": [],
  "restrictionDetectedAutomatically": false,
  "illegalContentReport": false
}
```

Video and image ads have `mediaType` set to `Video` or `Image` and a `mediaUrl` with the creative file. You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- The Ad Library covers Amazon's EU stores only. Amazon.com, Amazon.co.uk, and other non-EU stores have no ad library, so their URLs are skipped.
- Every EU store shows the same library, so a search on amazon.fr returns the same ads as on amazon.de.
- The search matches words in product titles and advertiser names, with the best matches first. Ads from other advertisers that mention your keyword are included too.
- The compliance search (removed ads) cannot be combined with a keyword, just like on the website. A compliance URL with a keyword is skipped; remove the keyword to get removed ads.
- Removed ads have no advertiser, payer, or product, so those fields are empty.
- Image and video links are temporary and stop working about 30 minutes after the run. Download the files right away if you need to keep them.
- Affiliate marketing content (creator videos) usually has no payer, end date, product link, impressions, or targeting; it links to its video page in `contentUrl`.
- Impressions are ranges as published by Amazon (for example 2,000 to 3,000), not exact numbers.
- Dates filter by when the ad was shown: an ad that ran at any time inside your range is included.

### Why use the Amazon Ad Library Scraper?

- ✅ **No login needed**: works with public data only, so there is no Amazon account to manage.
- 🎯 **Keeps your filters**: paste any Ad Library search URL from your browser and get exactly what you see there.
- 🌍 **All EU stores**: accepts URLs from all nine Amazon EU stores and filters by country.
- 🧹 **Clean data**: numbers are real numbers, dates use one standard format, and product ASINs are pulled out of the ad links.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of ads for your search.

#### Do I need an Amazon account?

No. The actor only collects publicly available data from the Ad Library. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh ads automatically.

#### Why are some fields empty?

Not every ad shows every piece of information. Some ads promote a brand store instead of a product, and some have no image or video. When a field is not available in the Ad Library, it is returned as `null` or an empty list.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, search queries, country, and date filters. If you need other filters or inputs, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Amazon Ad Library](https://www.amazon.de/adlibrary)

# Actor input Schema

## `startUrls` (type: `array`):

Amazon Ad Library URLs from any EU store (amazon.de, .fr, .it, .es, .nl, .pl, .se, .com.be, .ie): a search URL (/adlibrary/list, its keyword, dates and country are kept), a compliance search URL without keyword (/adlibrary/compliance/list, removed ads) or an ad detail URL (/adlibrary/detail/...).

## `searchQueries` (type: `array`):

Keywords to search in the Ad Library, for example a brand, advertiser or product name. Each query is scraped separately.

## `country` (type: `string`):

Only ads shown in this country. Applies to search queries; start URLs keep their own filters.

## `startDate` (type: `string`):

Only ads shown on or after this date (YYYY-MM-DD). Applies to search queries; start URLs keep their own filters.

## `endDate` (type: `string`):

Only ads shown on or before this date (YYYY-MM-DD). Applies to search queries; start URLs keep their own filters.

## `maxResults` (type: `integer`):

Maximum number of ads to scrape per start URL or search query. Set 0 for no limit.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.amazon.de/adlibrary/list?searchString=lego&location=Germany"
    }
  ],
  "searchQueries": [
    "nivea"
  ],
  "country": "All",
  "maxResults": 5
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.amazon.de/adlibrary/list?searchString=lego&location=Germany"
        }
    ],
    "searchQueries": [
        "nivea"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/amazon-ads-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.amazon.de/adlibrary/list?searchString=lego&location=Germany" }],
    "searchQueries": ["nivea"],
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/amazon-ads-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.amazon.de/adlibrary/list?searchString=lego&location=Germany"
    }
  ],
  "searchQueries": [
    "nivea"
  ]
}' |
apify call aboo.script/amazon-ads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/amazon-ads-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/MQF4evagaDye74MA6/builds/lm9QWAuwMihxXwMPR/openapi.json