Amazon APIamazon.com.mx ↗
Access Amazon.com.mx product search, details, bestsellers, deals, and autocomplete via a single REST API. Returns prices in MXN, ASINs, ratings, and more.
What is the Amazon API?
This API exposes 5 endpoints covering Amazon Mexico (amazon.com.mx), giving developers structured access to product listings, detailed product pages, autocomplete suggestions, category bestsellers, and live deals. The get_product_details endpoint alone returns 10 fields per product — including price in MXN, bullet-point features, high-resolution images, availability status, and review count — identified by ASIN.
curl -X GET 'https://api.parse.bot/scraper/4bb06ed4-5c2c-45f1-b1db-c2537b3e4855/search_products?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Amazon.com.mx by keyword. Returns a paginated list of products with their title, ASIN, price, rating, and image URL. Paginates via integer page number.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search keyword (e.g. 'laptop', 'audifonos') |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search query",
"products": "array of product objects with asin, title, price, currency, rating, reviews_count, image_url, url"
},
"sample": {
"data": {
"page": 1,
"query": "audifonos",
"products": [
{
"url": "https://www.amazon.com.mx/dp/B0DBHRWRKC",
"asin": "B0DBHRWRKC",
"price": 199,
"title": "XIAOMI Audífonos Redmi Buds 6 Play Negro",
"rating": 4.6,
"currency": "MXN",
"image_url": "https://m.media-amazon.com/images/I/613gJ8g29aL._AC_UL320_.jpg",
"reviews_count": 22354
}
]
},
"status": "success"
}
}About the Amazon API
Product Search and Details
The search_products endpoint accepts a query string and an optional page integer, returning paginated arrays of products with fields including asin, title, price, currency, rating, reviews_count, image_url, and url. For deeper data on any item, get_product_details takes a single asin parameter and returns the full product record: features (bullet-point list), description (long-form text), images (array of high-res URLs), availability (text status), and reviews_count. All monetary values from these endpoints are denominated in MXN.
Bestsellers and Deals
get_bestsellers accepts an optional category_slug and returns up to 30 ranked items, each with rank, asin, title, price, and rating. If no category_slug is provided, it defaults to the overall bestsellers list. The get_deals endpoint requires no inputs and returns currently featured promotions as an array of deal objects containing asin, title, price, currency, deal_type, deal_badge, and url — useful for monitoring flash sales and limited-time offers without manual browsing.
Autocomplete Suggestions
search_suggestions takes a partial query string and returns up to 10 autocomplete suggestion strings, mirroring the typeahead behavior on the site. This is useful for building search UIs, discovering related product categories, or understanding how shoppers phrase queries on the Mexican marketplace.
The Amazon API is a managed, monitored endpoint for amazon.com.mx — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.com.mx 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.mx 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 MXN price changes on specific ASINs for a price-drop alert service
- Build a product comparison tool that pulls
featuresandratingfromget_product_details - Populate a deals aggregator with
deal_typeanddeal_badgedata fromget_deals - Generate category-level bestseller reports using ranked items from
get_bestsellers - Implement a search autocomplete UI backed by
search_suggestions - Monitor
availabilitystatus on specific products to track stock levels over time - Aggregate
reviews_countandratingacross ASINs for competitive analysis on the Mexico marketplace
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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_details` return that `search_products` does not?+
search_products returns summary fields — asin, title, price, rating, reviews_count, and image_url. get_product_details adds features (the bullet-point list from the product page), a full description string, an images array with multiple high-resolution URLs, and an availability status field. Use search for discovery and get_product_details when you need the complete product record.Does the API cover seller information or third-party listings?+
How does pagination work in `search_products`?+
page parameter alongside your query. The response includes a page field confirming the current page. If page is omitted, the first page is returned. There is no explicit total-pages field in the response, so you increment page until you receive fewer results than a full page.Does the API return customer review text or only aggregate ratings?+
rating (average stars out of 5) and reviews_count (total number of reviews). Individual review text, reviewer names, and per-review ratings are not included. You can fork this API on Parse and revise it to add a reviews endpoint that returns individual review content for a given ASIN.