amazon.es APIamazon.es ↗
Search Amazon.es products, retrieve ASIN details, get autocomplete suggestions, and browse Best Sellers. Filters for price, brand, rating, and category.
curl -X GET 'https://api.parse.bot/scraper/b5d1b465-9cf8-49d0-8270-f40ac9e6ad29/search_products?query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Amazon.es with various filters. Returns paginated results with product title, price, rating, and ASIN.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number |
| sort | string | Sort order: featured, price-asc-rank, price-desc-rank, review-rank, date-desc-rank |
| brand | string | Brand name filter |
| queryrequired | string | Search keyword |
| category | string | Department/Category node or alias |
| max_price | number | Maximum price in EUR |
| min_price | number | Minimum price in EUR |
| min_rating | integer | Minimum star rating (1-5) |
| fast_delivery | boolean | Filter for 1-day delivery / Prime eligible |
{
"type": "object",
"fields": {
"page": "integer echoing the page number",
"items": "array of product objects with asin, title, price, rating, and url",
"query": "string echoing the search query",
"total": "integer count of products returned"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://www.amazon.es/dp/B0GFF77Y33",
"asin": "B0GFF77Y33",
"price": 313.22,
"title": "ASUS Chromebook Plus CX3402CVA – Laptop 14\" FHD",
"rating": 5
}
],
"query": "laptop",
"total": 53
},
"status": "success"
}
}About the amazon.es API
The Amazon.es API provides 4 endpoints for accessing product data from Spain's Amazon marketplace, covering search, detail lookup, autocomplete suggestions, and Best Sellers browsing. The search_products endpoint accepts keyword queries with filters for price range, brand, star rating, and category, returning ASINs, titles, prices, and ratings. The get_product_details endpoint goes deeper, exposing images, feature bullets, technical specs, and UPC codes for a single product by ASIN.
Search and Filtering
The search_products endpoint accepts a required query string plus optional filters: min_price and max_price in EUR, brand, min_rating (1–5 stars), and category for department targeting. Results are paginated via the page parameter and can be sorted by relevance (featured), price ascending or descending, review rank, or date. Each item in the items array includes the product's asin, title, price, rating, and url. The total field reflects the count of products returned on that page.
Product Details
The get_product_details endpoint takes a single 10-character asin and returns a full product record: title, brand, price in EUR, rating, an images array of URLs, a features array of bullet-point strings, a description, and ingredients (populated for food, supplement, and similar listings). A upc field surfaces the EAN/UPC barcode when Amazon's listing carries it — useful for cross-referencing products across catalogs.
Autocomplete and Best Sellers
The get_search_suggestions endpoint takes a query prefix and returns an array of suggestion objects, each with a value (the suggestion text) and a type field indicating the suggestion category. This mirrors the typeahead behavior visible in the Amazon.es search bar and is useful for query expansion or building search UIs.
The get_best_sellers endpoint returns a ranked list from Amazon.es's Best Sellers page. Each entry includes a rank integer and an asin. An optional category_node parameter accepts a category node ID or path segment to scope results to a specific department rather than the site-wide chart.
- Build a price-comparison tool for Spanish e-commerce by querying
search_productswithmin_price/max_pricefilters and tracking price changes by ASIN. - Populate a product catalog with structured data — titles, images, feature bullets, and descriptions — pulled from
get_product_details. - Monitor Best Sellers rankings by category node over time to spot trending products in specific Amazon.es departments.
- Implement search autocomplete in a shopping assistant using the
get_search_suggestionsendpoint for query-prefix completion. - Cross-reference Amazon.es product listings with other catalogs using the
upcfield returned byget_product_details. - Filter competitor product ranges by brand using the
brandparameter insearch_productsto audit listings and pricing. - Identify top-ranked ASINs from
get_best_sellersand enrich them with full detail records viaget_product_detailsfor category analysis.
| 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 | 250 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.es have an official developer API?+
What does `get_product_details` return beyond price and title?+
brand, price in EUR, rating, an images array, a features array (the bullet points from the listing), a description, a upc/EAN code when present, and an ingredients field populated for relevant product types like food or supplements.Does the API return customer reviews or review text?+
get_product_details endpoint returns the aggregate rating (average stars) but does not expose individual review text, reviewer names, or review dates. You can fork this API on Parse and revise it to add a reviews endpoint if that data is needed.How does pagination work in `search_products`?+
page parameter controls which page of results is returned. The response echoes the page value and includes a total count representing items on that page. There is no separate field for the total number of pages or aggregate result count across all pages, so you iterate by incrementing page until fewer items are returned.