mercadolivre.com.br APImercadolivre.com.br ↗
Access Mercado Livre daily deals, best sellers, categories, search suggestions, and supermarket products via a structured JSON API for Brazil's largest marketplace.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5c08b656-26a3-4907-88e3-e40e79c31dcd/get_daily_deals' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve current daily deals (Ofertas do dia) from Mercado Livre. Returns a list of discounted products with prices, discount percentages, and product URLs.
No input parameters required.
{
"type": "object",
"fields": {
"deals": "array of deal objects, each containing name, price, url, item_id, image, seller, free_shipping, rating, reviews_count, and discount"
},
"sample": {
"data": {
"deals": [
{
"url": "https://www.mercadolivre.com.br/kit-2-travesseiros-70x50-antialergico-lavavel-fibra-siliconada-toque-de-pluma-de-ganso-oaktex-cor-branco/p/MLB43954645",
"name": "Kit 2 Travesseiros 70x50 Antialérgico Lavável Fibra Siliconada Toque De Pluma De Ganso Oaktex Cor Branco",
"image": "https://http2.mlstatic.com/D_Q_NP_2X_774639-MLA100083759943_122025-AB.webp",
"price": 63.2,
"rating": null,
"seller": "Por Barão das Toalhas",
"item_id": "MLB43954645",
"discount": "43% OFF",
"free_shipping": true,
"reviews_count": null
}
]
},
"status": "success"
}
}About the mercadolivre.com.br API
This API exposes 5 endpoints covering Mercado Livre (mercadolivre.com.br), Brazil's largest online marketplace. You can retrieve current Ofertas do dia via get_daily_deals — each deal object includes name, price, discount percentage, seller, rating, reviews count, free-shipping flag, and a direct product URL — or browse ranked best-sellers, top-level categories, supermarket inventory, and autocomplete search suggestions.
Deals and Best Sellers
get_daily_deals returns the current Ofertas do dia as an array of deal objects. Each object carries name, price, url, item_id, image, seller, free_shipping, rating, reviews_count, and discount. No parameters are required — the endpoint reflects whatever deals Mercado Livre is currently promoting. get_best_sellers returns a similar shape with an added rank field so you can track position changes across polls. Both endpoints cover the full cross-category listing rather than a single department.
Categories and Supermarket
list_categories returns every top-level category Mercado Livre exposes, with each object providing name, url, and id. These IDs correspond to the standard Mercado Libre category taxonomy used across the MercadoLibre group. get_supermarket_products targets the Supermercado vertical specifically, returning grocery and household items with name, price, url, item_id, image, seller, free_shipping, rating, and reviews_count — the same shape as daily deals minus the discount field.
Search Suggestions
get_search_suggestions accepts a single required parameter, query, and returns the q (original query string) plus a suggested_queries array. Each suggestion carries its own q string, match_start and match_end character offsets indicating where the input was matched, an is_verified_store flag, and a filters array that reflects any category or facet constraints attached to that suggestion. This endpoint is useful for building typeahead interfaces or generating seed keyword lists from a partial input.
- Monitor Mercado Livre daily deal prices and discount percentages to feed a price-drop alert service.
- Track best-seller rank changes over time to identify trending products in the Brazilian e-commerce market.
- Seed a product database with supermarket inventory including seller names and free-shipping eligibility.
- Build a typeahead search component using suggested_queries with match_start/match_end highlight offsets.
- Map Mercado Livre category IDs to your own taxonomy using the list_categories endpoint.
- Aggregate rating and reviews_count across daily deals to surface highly-rated discounted items.
| 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 Livre have an official developer API?+
What does get_search_suggestions return beyond the query string?+
q), match_start and match_end integer offsets showing where in the suggestion the input prefix was matched, a boolean is_verified_store flag, and a filters array that may carry category or facet constraints tied to that suggestion. The filters are useful for routing a user directly to a pre-filtered search result page.Does the API support filtering best sellers or daily deals by category?+
get_best_sellers and get_daily_deals return site-wide results without a category filter parameter. list_categories does return category IDs, but no endpoint currently accepts a category ID to scope deal or best-seller results. You can fork this API on Parse and revise it to add category-scoped endpoints using those IDs.Does the API cover product detail pages, seller profiles, or customer reviews?+
How fresh is the daily deals data?+
get_daily_deals endpoint reflects the live Ofertas do dia listing. Mercado Livre rotates these deals throughout the day, so the response content will change as promotions start and end. There is no timestamp field in the response, so consumers should record their own retrieval time if freshness tracking matters to their application.