Amazon APIamazon.de ↗
Access Amazon.de product search, details, reviews, bestseller lists, seller info, and autocomplete suggestions via a single structured JSON API.
What is the Amazon API?
The Amazon.de API covers 6 endpoints that return structured product data from Amazon's German marketplace, including search results, individual product details, customer reviews, seller offer information, bestseller rankings, and autocomplete suggestions. The search_products endpoint returns up to a full paginated result set with fields like asin, price, rating, reviews_count, is_sponsored, and is_prime for each matched product.
curl -X GET 'https://api.parse.bot/scraper/450e804c-e517-40a7-987e-2b96bb99b1df/search_products?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace amazon-de-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Amazon.de SDK — search products, drill into details, check seller info."""
from parse_apis.amazon_de_api import AmazonDe, ProductNotFound
client = AmazonDe()
# Search for products — limit= caps total items fetched across pages.
for product in client.productsummaries.search(query="laptop", limit=5):
print(product.asin, product.title, product.price, product.is_prime)
# Drill into the first result's full details.
summary = client.productsummaries.search(query="kopfhörer", limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.stars, detail.availability)
# Check seller offer for this product.
offer = detail.seller_info()
print(offer.price, offer.sold_by, offer.availability)
# List customer reviews (single-page extraction from product page).
for review in detail.reviews.list(limit=3):
print(review.author, review.rating, review.date)
# Bestsellers — overall top sellers, capped at 5 items.
for item in client.bestsellers.list(limit=5):
print(item.rank, item.title, item.price)
# Autocomplete suggestions for a prefix.
for suggestion in client.suggestions.search(prefix="handy", limit=5):
print(suggestion.value, suggestion.type)
# Typed error handling: catch a not-found product.
try:
missing = client.products.get(asin="B000000000")
print(missing.title)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
print("exercised: productsummaries.search / details / seller_info / reviews.list / bestsellers.list / suggestions.search / products.get")
Full-text search over Amazon.de product listings by keyword. Returns a paginated list of product summaries including price, rating, and Prime eligibility. Advances via integer page counter. Each result carries an ASIN usable for detail/review/seller lookups.
| Param | Type | Description |
|---|---|---|
| rh | string | Amazon filter parameter (rh) for category or price filters. |
| page | integer | Page number for pagination (1-based). |
| queryrequired | string | Search keyword. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search keyword used",
"products": "array of product summary objects with asin, title, url, price, currency, rating, reviews_count, image_url, is_sponsored, is_prime",
"total_results_text": "string or null, results count text from Amazon"
}
}About the Amazon API
Product Search and Details
The search_products endpoint accepts a query string and optional page and rh filter parameters. The rh parameter mirrors Amazon's own category and price filter syntax, allowing narrowed searches by department or price band. Each result object includes asin, title, url, price, currency, rating, reviews_count, image_url, is_sponsored, and is_prime. Note that certain rh values or high page numbers may return upstream 503 errors due to Amazon's own rate-limiting on the German storefront.
The get_product_details endpoint takes a single asin and returns a richer set of fields: brand, price, stars, title, images (array), rating, description (feature bullets), availability, and a specifications key-value object. Some fields may be null depending on how a given product page is structured — this is especially common for third-party or low-traffic ASINs.
Reviews, Sellers, and Bestsellers
The get_product_reviews endpoint returns up to 8–13 reviews per call from the product page. Each review object contains id, author, rating, title, body, date, and verified status. The endpoint also surfaces total_ratings and overall_rating text. Pagination beyond page 1 is not currently supported — all reviews come from a single product page view.
The get_seller_info endpoint returns the main_offer object for an ASIN, with fields for price, ships_from, sold_by, merchant_info, and availability. The get_bestsellers endpoint accepts an optional category_node path segment (e.g., 'computers') and returns ranked items with rank, asin, title, url, price, rating, reviews_count, and image_url. The get_suggestions endpoint takes a prefix string and returns an array of autocomplete suggestion objects, each with a value and type field.
The Amazon API is a managed, monitored endpoint for amazon.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.de changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official amazon.de API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price changes on specific ASINs using
get_product_detailsprice and availability fields - Build category-level bestseller monitors using
get_bestsellerswithcategory_nodefiltering - Aggregate customer sentiment by collecting
body,rating, andverifiedfields fromget_product_reviews - Identify sponsored vs. organic product placement using the
is_sponsoredflag fromsearch_products - Enrich product feeds with
brand,specifications, andimagesdata fromget_product_details - Implement German-language search autocomplete using
get_suggestionsprefix responses - Compare seller and fulfillment details across ASINs using
sold_byandships_fromfromget_seller_info
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Amazon.de have an official developer API?+
How many reviews does `get_product_reviews` return, and can I paginate through all of them?+
total_ratings and overall_rating fields are still returned so you know the full volume even when individual review text is limited. You can fork this API on Parse and revise it to add a dedicated reviews-pagination endpoint if your use case requires more complete review coverage.Can I filter `search_products` results by price range or product category?+
rh parameter, which accepts Amazon's native filter string format (e.g., category node IDs, price range tokens). Be aware that some rh values can trigger upstream 503 errors from Amazon's German storefront, so error handling on that parameter is recommended.Does the API return third-party seller listings or only the featured offer?+
get_seller_info returns the main offer for an ASIN — the sold_by, ships_from, price, and availability of the featured buy-box offer. It does not enumerate all competing seller offers for an ASIN. You can fork this API on Parse and revise it to add a multi-offer listing endpoint that surfaces the full seller list.Are there known reliability issues with any endpoints?+
search_products is the most likely endpoint to encounter upstream 503 errors, particularly when using certain rh filter values or requesting higher page numbers. This is a limitation of Amazon.de's own responses and not specific to any particular query format. Building retry logic into your client is advisable for paginated or heavily filtered searches.