amazon.com.mx APIamazon.com.mx ↗
Access Amazon.com.mx product search, details, bestsellers, deals, and autocomplete via a single REST API. Prices, ratings, and availability in MXN.
curl -X GET 'https://api.parse.bot/scraper/4bb06ed4-5c2c-45f1-b1db-c2537b3e4855/search_products?page=2&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.
| 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": "laptop",
"products": [
{
"url": "https://www.amazon.com.mx/dp/B0FX4GNV7C",
"asin": "B0FX4GNV7C",
"price": 10499.99,
"title": "KAIGERR Laptop Ryzen 5 7430U 16GB RAM 512GB SSD",
"rating": null,
"currency": "MXN",
"image_url": "https://m.media-amazon.com/images/I/71Psp19EMxL._AC_UL320_.jpg",
"reviews_count": 0
}
]
},
"status": "success"
}
}About the amazon.com.mx API
This API covers amazon.com.mx across 6 endpoints, returning product data including titles, ASINs, MXN prices, ratings, review counts, and image URLs. The get_product_details endpoint returns up to 10 distinct fields per product — including bullet-point features, full description text, high-resolution images, and availability status — while get_bestsellers surfaces up to 30 ranked items per category and get_deals returns active promotions with discount badges.
Product Search and Detail
The search_products endpoint accepts a query string (e.g. 'laptop' or 'audifonos') and an optional page integer for pagination. Each result in the products array includes asin, title, price, currency (always MXN), rating, reviews_count, image_url, and a direct url to the listing. To fetch full details for any ASIN, pass it to get_product_details, which returns the features bullet list, description text, an images array of high-resolution URLs, availability status, and a reviews_count integer alongside pricing and rating.
Bestsellers, Deals, and Suggestions
The get_bestsellers endpoint accepts a category_slug such as 'electronics', 'books', 'beauty', or 'grocery' and returns up to 30 ranked items, each with rank, asin, title, price, and rating. The get_deals endpoint requires no inputs and returns currently featured promotions, including deal_type, deal_badge, discounted price, and a direct url per deal. For autocomplete behavior, search_suggestions takes a partial query string and returns up to 10 suggestion strings — useful for building search interfaces or discovering how shoppers phrase queries on the Mexican marketplace.
Endpoint Limitations
The get_product_offers endpoint, which is intended to return multiple seller offers for a given ASIN, is currently blocked by AWS WAF protection on the amazon.com.mx side. Calls will return an asin and an empty offers array until this is resolved. All other endpoints return live data. Prices and availability reflect the current state of the listing at the time of the request.
- Track MXN price changes across multiple ASINs using
get_product_detailsfor competitive intelligence in the Mexican market. - Build a deal aggregator that polls
get_dealsto surface discounted items with theirdeal_badgeand discounted price. - Populate category pages with
get_bestsellersusing slugs like'electronics'or'baby'for ranked product lists. - Power a search autocomplete UI by feeding partial user input to
search_suggestionsand returning up to 10 query completions. - Scrape feature bullet points and descriptions via
get_product_detailsto generate structured product catalogs or comparison tables. - Monitor product availability status (
availabilityfield) across multiple ASINs to detect out-of-stock and restock events. - Aggregate review counts from
search_productsandget_product_detailsto identify high-engagement products in a given category.
| 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 have an official developer API?+
What does `get_product_details` return beyond what `search_products` provides?+
search_products endpoint returns a summary per product: asin, title, price, rating, reviews_count, and image_url. The get_product_details endpoint adds the full features array (bullet points), a description text field, an images array with multiple high-resolution URLs, and an availability status string — none of which appear in search results.Can I retrieve seller offers or third-party pricing for a product?+
get_product_offers endpoint is designed to return multiple seller offers per ASIN, but it is currently blocked by AWS WAF protection on amazon.com.mx and returns an empty offers array. The API covers first-party listing prices via get_product_details. You can fork this API on Parse and revise it to add a working offers endpoint when the blocking condition changes.Are customer reviews or individual review text available?+
rating (out of 5) and reviews_count integers 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 targeting the amazon.com.mx review pages.How does pagination work for `search_products`?+
search_products endpoint accepts an optional page integer parameter. The response echoes back the current page number alongside the query string and the products array. If page is omitted, results default to the first page. Amazon.com.mx typically limits deep pagination, so very high page numbers may return empty results.