mercadolibre.com.mx APImercadolibre.com.mx ↗
Search products, browse categories, retrieve listings, check daily deals, and look up seller reputation on Mercado Libre Mexico via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/806a3b41-a814-49f2-9e7e-754a9a017499/search_products?query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Mercado Libre Mexico. Note: Direct search may be blocked by account verification challenges; consider using category listings or offers as an alternative.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword |
{
"type": "object",
"fields": {
"url": "string",
"items": "array",
"query": "string"
},
"sample": {
"items": [
{
"id": "MLM12345",
"url": "https://...",
"price": 1500,
"title": "Product Title",
"currency": "MXN",
"thumbnail": "https://..."
}
],
"query": "laptop"
}
}About the mercadolibre.com.mx API
This API gives programmatic access to Mercado Libre Mexico across 6 endpoints, covering product search, full item detail, category listings, daily offers, and seller profiles. The get_product_detail endpoint returns structured fields including title, pricing, images, and availability by item ID, while get_offers surfaces paginated deal data with discount percentages and ratings in a single call.
Product and Listing Data
The get_product_detail endpoint accepts a Mercado Libre item ID (with or without the MLM prefix) and returns an id, title, and a components array that carries pricing, images, seller attribution, and availability details. For browsing without a specific ID, get_category_listings accepts a full category_url and returns an items array alongside the category title. Category URLs can be sourced directly from get_categories, which returns the complete list of top-level categories — each entry carrying a name and a url.
Offers and Search
The get_offers endpoint retrieves current daily deals and promotions. Each item in the items array includes title, url, id, price, original_price, discount, brand, image, and rating. The paging object tells you the current page, how many items_on_page were returned, and whether has_next is true, making it straightforward to walk through multiple pages of active promotions.
The search_products endpoint accepts a query string and returns a matching items array plus the resolved url for the search. Note that direct keyword searches may encounter account verification challenges on the source; using get_category_listings or get_offers is a reliable alternative when consistent coverage matters.
Seller Profiles
The get_seller_info endpoint resolves a seller nickname or ID — typically found in a get_product_detail response — and returns the seller's name, seller_id, and reputation standing. This is useful for assessing vendor credibility before committing to a price comparison or procurement workflow.
- Track price drops on specific MLM item IDs using
get_product_detailpricing fields - Aggregate daily deal data with discount percentages from
get_offersfor a deals newsletter - Build a category browser by walking
get_categoriesURLs intoget_category_listings - Cross-reference seller
reputationscores fromget_seller_infoagainst product listings - Monitor competitor product availability and pricing across Mercado Libre Mexico categories
- Populate a price-comparison tool with
original_priceanddiscountfields from offers - Audit seller profiles by resolving seller IDs from product details through
get_seller_info
| 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 Mercado Libre have an official developer API?+
What does `get_offers` return beyond basic pricing?+
title, url, id, price, original_price, discount, brand, image, and rating. The paging object exposes page, items_on_page, and has_next so you can iterate through all active promotions page by page.Does `search_products` always return results reliably?+
search_products can be interrupted by account verification challenges on Mercado Libre. The get_category_listings and get_offers endpoints are more consistent alternatives for batch data retrieval.Does the API return product reviews or buyer feedback?+
Is seller data limited to reputation only?+
get_seller_info returns name, seller_id, and reputation. Detailed metrics like total sales volume, response time, or shipping performance are not currently included. You can fork this API on Parse and revise it to pull those additional seller metrics if they are available on the seller profile page.