# Amazon Details ASIN Scraper for Germany (`nezha/amazon-details-asin-germany`) Actor

Extract Amazon.de product detail data from ASINs or product URLs, including title, brand, price, reviews, availability, product information, images, bestseller rank, and answered questions count.

- **URL**: https://apify.com/nezha/amazon-details-asin-germany.md
- **Developed by:** [nezha](https://apify.com/nezha) (community)
- **Categories:** E-commerce, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Amazon Details ASIN Scraper for Germany

Turn known Amazon.de ASINs into structured Germany product detail records with prices, ratings, availability, product bullets, technical attributes, image URLs, bestseller rank, and optional answered questions count.

### What this Actor does

This Actor is built for detail-page extraction, not product discovery. You provide ASINs or Amazon.de product URLs, and the Actor opens each product at:

```text
https://www.amazon.de/dp/{ASIN}
````

It is useful when you want to:

- enrich a known product list with Amazon Germany detail fields
- monitor price, stock text, ratings, and review counts on Amazon.de
- collect product content, attributes, and image URLs for catalog or research workflows
- turn an internal ASIN list into exportable CSV, Excel, or JSON output

### Quick start

1. Paste one or more ASINs into **ASINs or Amazon.de URLs**.
2. Keep `maxItems: 10`, `requestDelaySecs: 2`, and `includeQuestionsCount: true` for the first run.
3. Use a German proxy for the most consistent Amazon.de output.
4. Click **Run** and export the dataset as CSV, Excel, or JSON.

### Proxy recommendation

Use a German proxy whenever possible. Amazon may localize prices, availability, delivery messages, language, taxes, and redirects based on the request location. For the most consistent Amazon.de results, configure Apify Proxy with Germany as the country.

### Use cases

**Catalog enrichment**\
Start from a known ASIN list and export titles, brands, prices, bullets, dimensions, image URLs, and product information for downstream systems.

**Price and availability monitoring**\
Track Amazon.de detail-page changes such as current price, list price, review count, stock text, and bestseller rank.

**Marketplace research**\
Collect product bullets, descriptions, technical attributes, and answered question counts for category research or competitor analysis.

### Output preview

| ASIN | Title | Price | Rating | Reviews | Availability |
| --- | --- | --- | --- | --- | --- |
| B08N5WRWNW | Echo Dot ... | 59,99 EUR | 4,7 von 5 Sternen | 120.000 Bewertungen | Auf Lager |

Typical fields include:

- product identity: `ASIN`, `Webseite_URL`, `Titel`, `Marke`
- market signals: `Kundenbewertung`, `Anzahl_der_Bewertungen`, `Anzahl_der_beantworteten_Fragen`
- price and availability: `Verkaufspreis`, `UVP`, `Bestand`
- content and specs: `Stichpunkte`, `Produkt_Information`, `Produkt_Beschreibung`, `Farbe`, `Hersteller`, `Kapazität`, `Produkt_Dimensionen`
- ranking and timing: `Reihe_der_Bestseller`, `Datum_Erste_Verfügbar`, `Aktuelle_Zeit`
- media: `Bild_URL_1` through `Bild_URL_10`

#### Example input

```json
{
  "asins": ["B08N5WRWNW", "https://www.amazon.de/dp/B0C7Q9MJ1T"],
  "maxItems": 2,
  "maxRetries": 3,
  "requestDelaySecs": 2,
  "includeQuestionsCount": true,
  "maxImages": 6,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [],
    "countryCode": "DE"
  }
}
```

### Best practices

- Use plain ASINs when you already have a product list from another system.
- Use `startUrls` when teammates prefer Apify's URL list editor.
- Keep `requestDelaySecs` above zero for more stable Amazon runs.
- Enable `includeQuestionsCount` only when you need the extra Q\&A field.
- Failed product or Q\&A pages are stored in `FAILED_ASINS`, so one failed request does not stop the whole run.

# Actor input Schema

## `asins` (type: `array`):

Amazon ASINs or Amazon.de product URLs. The Actor extracts the 10-character ASIN automatically, removes duplicates, and crawls https://www.amazon.de/dp/{ASIN}.

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

Optional alternative input for Amazon.de product URLs. ASINs are extracted from /dp/ and /gp/product/ URLs.

## `maxItems` (type: `integer`):

Maximum number of unique ASINs to process in one run.

## `maxRetries` (type: `integer`):

How many times to retry a product or Q\&A page before recording it in FAILED\_ASINS.

## `requestDelaySecs` (type: `integer`):

Polite delay before each request. Amazon can throttle aggressive crawls, so keep a small delay for more stable runs.

## `includeQuestionsCount` (type: `boolean`):

When enabled, the Actor follows the product Q\&A link when available and extracts the German questions count.

## `maxImages` (type: `integer`):

Maximum number of product image URLs to save as Bild\_URL\_1, Bild\_URL\_2, and so on. The Actor attempts to convert thumbnails to higher-resolution Amazon image URLs.

## `proxyConfiguration` (type: `object`):

Use a German proxy or Apify Proxy with Germany as the country for the most consistent Amazon.de results. Amazon may change prices, availability, delivery messages, language, or redirects based on request location.

## Actor input object example

```json
{
  "asins": [
    "B08N5WRWNW"
  ],
  "startUrls": [
    {
      "url": "https://www.amazon.de/dp/B08N5WRWNW"
    }
  ],
  "maxItems": 50,
  "maxRetries": 3,
  "requestDelaySecs": 2,
  "includeQuestionsCount": true,
  "maxImages": 6
}
```

# Actor output Schema

## `dataset` (type: `string`):

Structured Amazon Germany product detail records by ASIN.

## `outputSummary` (type: `string`):

Input settings, proxy guidance, and crawl statistics.

## `failedAsins` (type: `string`):

ASINs or Q\&A pages that failed after retries.

# 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 = {
    "asins": [
        "B08N5WRWNW"
    ],
    "startUrls": [
        {
            "url": "https://www.amazon.de/dp/B08N5WRWNW"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("nezha/amazon-details-asin-germany").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 = {
    "asins": ["B08N5WRWNW"],
    "startUrls": [{ "url": "https://www.amazon.de/dp/B08N5WRWNW" }],
}

# Run the Actor and wait for it to finish
run = client.actor("nezha/amazon-details-asin-germany").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "asins": [
    "B08N5WRWNW"
  ],
  "startUrls": [
    {
      "url": "https://www.amazon.de/dp/B08N5WRWNW"
    }
  ]
}' |
apify call nezha/amazon-details-asin-germany --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nezha/amazon-details-asin-germany",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Amazon Details ASIN Scraper for Germany",
        "description": "Extract Amazon.de product detail data from ASINs or product URLs, including title, brand, price, reviews, availability, product information, images, bestseller rank, and answered questions count.",
        "version": "0.1",
        "x-build-id": "ltGWgBeM4LtidTMat"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nezha~amazon-details-asin-germany/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nezha-amazon-details-asin-germany",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/nezha~amazon-details-asin-germany/runs": {
            "post": {
                "operationId": "runs-sync-nezha-amazon-details-asin-germany",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/nezha~amazon-details-asin-germany/run-sync": {
            "post": {
                "operationId": "run-sync-nezha-amazon-details-asin-germany",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "asins": {
                        "title": "ASINs or Amazon.de URLs",
                        "type": "array",
                        "description": "Amazon ASINs or Amazon.de product URLs. The Actor extracts the 10-character ASIN automatically, removes duplicates, and crawls https://www.amazon.de/dp/{ASIN}.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "startUrls": {
                        "title": "Amazon.de Product URLs",
                        "type": "array",
                        "description": "Optional alternative input for Amazon.de product URLs. ASINs are extracted from /dp/ and /gp/product/ URLs.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxItems": {
                        "title": "Max Products",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of unique ASINs to process in one run.",
                        "default": 50
                    },
                    "maxRetries": {
                        "title": "Retries Per Request",
                        "minimum": 1,
                        "type": "integer",
                        "description": "How many times to retry a product or Q&A page before recording it in FAILED_ASINS.",
                        "default": 3
                    },
                    "requestDelaySecs": {
                        "title": "Delay Between Requests",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Polite delay before each request. Amazon can throttle aggressive crawls, so keep a small delay for more stable runs.",
                        "default": 2
                    },
                    "includeQuestionsCount": {
                        "title": "Include Answered Questions Count",
                        "type": "boolean",
                        "description": "When enabled, the Actor follows the product Q&A link when available and extracts the German questions count.",
                        "default": true
                    },
                    "maxImages": {
                        "title": "Max Images",
                        "minimum": 1,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Maximum number of product image URLs to save as Bild_URL_1, Bild_URL_2, and so on. The Actor attempts to convert thumbnails to higher-resolution Amazon image URLs.",
                        "default": 6
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Use a German proxy or Apify Proxy with Germany as the country for the most consistent Amazon.de results. Amazon may change prices, availability, delivery messages, language, or redirects based on request location."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
