Amazon APIamazon.nl ↗
Access Amazon.nl product search, full product details, customer reviews, and bestseller lists via a single structured API. Returns prices in EUR, ASINs, and specs.
What is the Amazon API?
The Amazon.nl API gives developers structured access to Amazon's Dutch marketplace across 4 endpoints: search products by keyword, retrieve full product details by ASIN, fetch customer reviews, and pull category bestseller lists. The get_product_details endpoint alone returns over 10 fields including price in EUR, technical specifications, availability status, brand, images, and breadcrumb categories.
curl -X GET 'https://api.parse.bot/scraper/555cec91-d32e-48ff-aa50-e20f36a0da85/search_products?page=1&query=laptop&category=electronics' \ -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-nl-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.nl SDK — search products, get details, browse bestsellers."""
from parse_apis.amazon_nl_api import AmazonNl, Sort, Category_, ProductNotFound
client = AmazonNl()
# Search for laptops in electronics, sorted by price low-to-high
for product in client.category("electronics").search(query="laptop", sort=Sort.PRICE_ASC, limit=3):
print(product.name, product.price, product.url)
# Get full details for one product from search results
item = client.category("electronics").search(query="headphones", limit=1).first()
if item:
detail = item.details()
print(detail.name, detail.brand, detail.price, detail.availability)
for bullet in detail.description[:2]:
print(" -", bullet)
# Browse bestsellers in a category
for bs in client.category("toys").bestsellers(limit=5):
print(bs.rank, bs.name, bs.price, bs.rating)
# Fetch reviews for a known product
product = client.products.get(asin="B0DCNWN8NZ")
for review in product.reviews(limit=3):
print(review.author, review.rating, review.title)
# Typed error handling for a non-existent product
try:
client.products.get(asin="B000000000")
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
print("exercised: category.search / product.details / category.bestsellers / products.get / product.reviews")
Search for products on Amazon.nl by keyword. Returns paginated results with product names, prices, ratings, and thumbnails. Each page typically returns up to 48 results. Pagination via integer page counter. Sort and category filters are forwarded to Amazon's search engine.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. Accepted values include price-asc-rank (price low to high), price-desc-rank (price high to low), review-rank (average customer review), date-desc-rank (newest arrivals). |
| queryrequired | string | Search keyword. |
| category | string | Category node ID or slug to filter results (e.g. electronics, toys, computers). |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"query": "string - the search query used",
"products": "array of product objects with asin, name, price, rrp, rating, review_count, thumbnail_url, url"
},
"sample": {
"data": {
"page": 1,
"query": "laptop",
"products": [
{
"rrp": null,
"url": "https://www.amazon.nl/dp/B0F8L98RLY/",
"asin": "B0F8L98RLY",
"name": "HP Laptop | 15.6\" FHD Display | Intel N100 | 4GB DDR4 RAM | 128GB UFS",
"price": 284.99,
"rating": null,
"review_count": null,
"thumbnail_url": "https://m.media-amazon.com/images/I/71PLxZEF7WL._AC_UL320_.jpg"
}
]
},
"status": "success"
}
}About the Amazon API
Search and Discovery
The search_products endpoint accepts a required query string and returns paginated product listings with asin, name, price, rrp, rating, review_count, thumbnail_url, and url. Results can be filtered by category (node ID or slug) and sorted using sort values like price-asc-rank or review-rank. Use the page parameter to walk through result sets.
Product Details and Specifications
The get_product_details endpoint takes a 10-character asin and returns the full product record: name, brand, price (EUR), availability, seller, images (array of URLs), description (array of bullet strings), breadcrumbs, and technical_specifications as a flat key-value object. This makes it straightforward to compare specs across products or build enriched product listings.
Reviews and Bestsellers
The get_product_reviews endpoint returns up to 13 top reviews per ASIN, each with author, rating, title, body, and date. Note this reflects the reviews surfaced on the product page, not the full review corpus. The get_bestsellers endpoint retrieves up to 30 ranked items for a given category slug (e.g. electronics, toys), returning rank, name, price, rating, review_count, and asin for each entry — useful for competitive analysis or trend monitoring.
The Amazon API is a managed, monitored endpoint for amazon.nl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.nl 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.nl 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 across Amazon.nl using
get_product_details. - Build a price comparison tool using
search_productswithsort=price-asc-rank. - Monitor category bestseller rankings weekly with
get_bestsellersfor trend analysis. - Aggregate technical specifications from
technical_specificationsto compare electronics or appliances. - Feed customer review sentiment pipelines using
bodyandratingfields fromget_product_reviews. - Populate a product catalog with localized EUR pricing, brand, and availability data from Amazon.nl.
- Identify top-reviewed products in a category by cross-referencing
review_countfromget_bestsellers.
| 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 have an official developer API?+
What does `get_product_reviews` actually return, and are all reviews included?+
author, rating (numeric), title, body, and date. It does not paginate through the full review history. If you need deeper review coverage, you can fork this API on Parse and revise it to add review pagination.Can I retrieve seller inventory data or third-party seller listings for a product?+
get_product_details returns a single seller string and availability status, but does not enumerate multiple sellers, offer listings, or fulfillment-by-Amazon details. You can fork this API on Parse and revise it to add a seller listings endpoint.How does bestseller category filtering work?+
get_bestsellers endpoint accepts an optional category slug corresponding to Amazon.nl's bestseller URL path segments, such as electronics or toys. Omitting the parameter returns results from the overall bestsellers list. The response always includes up to 30 ranked items with rank, asin, name, price, rating, and review_count.