Mercado Libre APImercadolibre.com.mx ↗
Access Mercado Libre Mexico product listings, category hierarchies, and daily deals via 3 endpoints. Get prices, discounts, brands, ratings, and pagination.
What is the Mercado Libre API?
The Mercado Libre Mexico API covers 3 endpoints that return product categories, category-level listings, and daily promotional offers from mercadolibre.com.mx. The get_offers endpoint delivers up to 48 offer cards per page with fields including price, original_price, discount, brand, image, and rating. The get_categories endpoint exposes a hierarchical department structure, making it straightforward to map the full category tree before fetching listings.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/806a3b41-a814-49f2-9e7e-754a9a017499/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve all product categories from Mercado Libre Mexico organized by department. Returns hierarchical category data including top-level categories with their child subcategories. Each category includes an ID, name, URL, and department grouping.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects with id, name, url, department, and optional children array"
},
"sample": {
"data": {
"categories": [
{
"id": "MLM1051",
"url": "https://www.mercadolibre.com.mx/c/celulares-y-telefonia#menu=categories",
"name": "Celulares y Telefonía",
"children": [
{
"id": "MLM1055",
"url": "https://listado.mercadolibre.com.mx/celulares-telefonia/celulares-smartphones/#menu=categories",
"name": "Celulares y Smartphones"
}
],
"department": "Tecnología"
},
{
"id": "MLM1648",
"url": "https://www.mercadolibre.com.mx/c/computacion#menu=categories",
"name": "Computación",
"children": [
{
"id": "MLM1652",
"url": "https://listado.mercadolibre.com.mx/computacion/laptops-accesorios/laptops/#menu=categories",
"name": "Laptops"
}
],
"department": "Tecnología"
}
]
},
"status": "success"
}
}About the Mercado Libre API
Category and Listing Data
The get_categories endpoint requires no inputs and returns an array of category objects, each with id, name, url, department, and an optional children array for subcategories. This gives you a complete picture of how Mercado Libre Mexico organizes its product catalog by department. Once you have a category URL in the https://www.mercadolibre.com.mx/c/ format, you can pass it to get_category_listings via the category_url parameter. That endpoint returns a title string and an items array where each product object carries title, url, id, price, original_price, discount, brand, image, and rating.
Offers and Promotions
The get_offers endpoint retrieves current daily deals without requiring a category URL. It accepts an optional page integer (starting at 1) and returns 48 offer cards per page. The response includes an items array with the same product fields as category listings, plus a paging object containing page, items_on_page, and has_next (boolean) for walking through additional pages. Fields like discount, brand, original_price, and rating are null when the offer card does not display them.
Data Shape and Coverage
All three endpoints share a consistent product object shape: title, url, id, price, original_price, discount, brand, image, and rating. The id field maps to the Mercado Libre item identifier, which appears in the product URL. Category coverage mirrors what the Mexico storefront exposes publicly, from computing and electronics to fashion and home goods. Seller-level fields, reviews text, and item-level attribute specs are outside the current response schema.
The Mercado Libre API is a managed, monitored endpoint for mercadolibre.com.mx — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mercadolibre.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 mercadolibre.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 price drops on daily deals by polling
get_offersacross multiple pages and comparingpricevsoriginal_price. - Build a category browser for a Mexico-focused shopping app using the
childrenarrays returned byget_categories. - Monitor discount percentages across product categories by aggregating the
discountfield fromget_category_listings. - Identify which brands appear most frequently in a category's listings using the
brandfield fromget_category_listings. - Seed a price-comparison database with Mercado Libre Mexico product IDs and current prices for electronics or apparel categories.
- Detect trending promoted products by periodically fetching
get_offersand flagging items that recur across multiple daily deal pages.
| 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 Mercado Libre have an official developer API?+
What does `get_category_listings` return and how should I choose the category URL?+
title string and an items array of product objects. Each item includes title, url, id, price, original_price, discount, brand, image, and rating. Top-level URLs in the https://www.mercadolibre.com.mx/c/<slug> format (available from get_categories) give the most reliable results; subcategory or filtered URLs may return fewer items.Are individual product detail pages or seller profiles covered?+
Can I paginate through all category listings, not just offers?+
get_offers supports pagination via the page parameter and exposes a has_next flag. get_category_listings does not currently accept a page or offset parameter, so it returns a single page of results for a given category URL. You can fork this API on Parse and revise it to add pagination support for category listings.Are `discount`, `brand`, `original_price`, and `rating` always populated?+
null when the listing card does not display that information — for example, items without an active promotion will have null for discount and original_price, and not all products display a rating on their card.