Com APIamazon.com.be ↗
Search Amazon.com.be products, retrieve ASIN details (price, features, availability), and fetch autocomplete suggestions via a clean REST API.
What is the Com API?
The Amazon Belgium API provides 3 endpoints to query the Amazon.com.be catalog: search products with sorting and EUR price filters, fetch full product details by ASIN including brand, feature bullets, images, and availability, and retrieve up to 10 autocomplete suggestions for a given search prefix. The search_products endpoint returns paginated results with 9 fields per product, making it straightforward to build price-comparison or catalog-mirroring tools targeting the Belgian market.
curl -X GET 'https://api.parse.bot/scraper/12439636-4f16-4d13-9bdf-4c877a56e8ed/search_products?page=1&sort=relevance&query=laptop&max_price=100&min_price=10' \ -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-com-be-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.
from parse_apis.amazon_belgium_product_search_api import AmazonBelgium, Sort, ProductNotFound
amazon = AmazonBelgium()
# Search for products with sorting and price filter
for product in amazon.searchresults.search(query="wireless headphones", sort=Sort.AVG_CUSTOMER_REVIEW, min_price="20", max_price="100", limit=5):
print(product.title, product.price, product.rating, product.is_prime)
# Get autocomplete suggestions
for suggestion in amazon.searchresults.suggest(prefix="laptop"):
print(suggestion.value, suggestion.type)
# Get full product details by ASIN
detail = amazon.products.get(asin="B0BTJD6LCL")
print(detail.title, detail.brand, detail.price, detail.rating, detail.availability)
# Navigate from summary to full details
for item in amazon.searchresults.search(query="sony headphones", sort=Sort.BEST_SELLERS, limit=2):
full = item.details()
print(full.title, full.brand, full.features)
Search for products on Amazon Belgium. Returns paginated results with product details including price, rating, and review count. Supports sorting by relevance, price, customer reviews, newest arrivals, and best sellers. Supports price range filtering in EUR. Results are locale-dependent and may appear in Dutch, French, or English.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| sort | string | Sort order for search results. |
| queryrequired | string | Search query string (e.g. 'wireless headphones', 'laptop'). |
| max_price | string | Maximum price filter in EUR. Numeric value as string (e.g. '50' for €50). |
| min_price | string | Minimum price filter in EUR. Numeric value as string (e.g. '20' for €20). |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"sort": "string - sort order applied",
"query": "string - the search query used",
"products": "array of product objects with asin, title, price, rating, review_count, image_url, product_url, is_prime",
"total_results": "integer or null - estimated total result count"
},
"sample": {
"data": {
"page": 1,
"sort": "relevance",
"query": "laptop",
"products": [
{
"asin": "B0DDP3T8SD",
"price": "€12.38",
"title": "Tisino 3.5 mm naar dubbele 6.35 mm TS stereo audiokabel",
"rating": 4.8,
"is_prime": false,
"image_url": "https://m.media-amazon.com/images/I/61Z6sZrKLLL._AC_UL320_.jpg",
"product_url": "https://www.amazon.com.be/dp/B0DDP3T8SD",
"review_count": 136
}
],
"total_results": 100000
},
"status": "success"
}
}About the Com API
Search and Filter Products
The search_products endpoint accepts a required query string and optional parameters for pagination (page), sort order (sort), and EUR price bounds (min_price, max_price). Sort accepts five values: relevance, price_low_to_high, price_high_to_low, avg_customer_review, and newest_arrivals. Each item in the returned products array includes asin, title, price, rating, review_count, image_url, product_url, and is_prime. The total_results field gives the full result count reported by the catalog, though it may be null for some queries.
Product Detail by ASIN
The get_product_details endpoint takes a single asin string — typically sourced from search_products results — and returns a richer set of fields: brand, features (an array of bullet-point strings), description, images (all image URLs for the listing), availability, rating, and review_count. Price is returned as a string or null when the listing has no buyable offer. This endpoint is suited for populating detailed product pages or feeding structured data into a catalogue database.
Autocomplete Suggestions
The get_search_suggestions endpoint accepts a partial query string via the prefix parameter and returns up to 10 suggestion objects. Each suggestion contains a value (the full suggested search term) and a type field. This is useful for building type-ahead search interfaces or generating keyword lists for product research tools.
Coverage Notes
All prices are denominated in EUR and reflect the Amazon.com.be locale. ASINs are consistent with the wider Amazon catalog, so an ASIN obtained from this API can generally be cross-referenced against other Amazon locale APIs. Review text and individual reviewer data are not included in any endpoint; only aggregate rating and review_count are exposed.
The Com API is a managed, monitored endpoint for amazon.com.be — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.com.be 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.com.be 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?+
- Build a EUR price tracker that monitors
pricechanges for a set of ASINs on Amazon Belgium over time. - Populate a product comparison widget using
features,brand, andimagesfromget_product_details. - Implement a type-ahead search bar backed by
get_search_suggestionsfor an affiliate or shopping site. - Aggregate
ratingandreview_countacross multiple ASINs to rank products in a niche category. - Filter search results by
min_priceandmax_priceto surface budget or premium product segments in the Belgian market. - Check
availabilityandis_primefields to filter for Prime-eligible, in-stock items before surfacing them to users. - Generate keyword research datasets by feeding product category terms into
get_search_suggestionsand expanding the prefix tree.
| 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 for product data?+
What does `get_product_details` return that `search_products` does not?+
get_product_details endpoint adds brand, features (the full list of bullet-point descriptions), description (long-form product text), and an images array containing all product image URLs. The search endpoint returns only a single image_url and omits brand, feature bullets, and long descriptions.Does `search_products` return seller or offer-level data, such as third-party seller names or multiple price offers for the same ASIN?+
price field per product and does not expose individual seller names, fulfilled-by details, or competing offer prices for the same ASIN. You can fork this API on Parse and revise it to add an offers endpoint that captures seller-level pricing data.Are customer reviews and review text available through this API?+
rating (numeric) and review_count (integer) for both search results and product detail responses, but individual review text, reviewer names, and review dates are not returned by any endpoint. You can fork this API on Parse and revise it to add a reviews endpoint for a given ASIN.How does pagination work in `search_products`, and are there limits on how deep you can paginate?+
page parameter is 1-based integer pagination. The total_results field in the response indicates the total number of matching products, though it can be null for some queries. Amazon Belgium generally limits result depth to around 400 results (roughly 20–25 pages depending on the number of results per page), regardless of the total count shown.