Discover/MercadoLibre API

live

MercadoLibre APImercadolibre.com ↗

Access MercadoLibre product listings, reviews, categories, and deals across 7 Latin American country sites via a single structured API.

Marketplace ecommerce reviews ratings

Endpoint health

verified 4d ago

get_offers_deals

get_product_reviews

get_category_list

3/3 passing latest checkself-healing

Endpoints

Updated

21d ago

What is the MercadoLibre API?

The MercadoLibre API covers 5 endpoints that return product listings, full product details, customer reviews, category trees, and live deals across 7 country sites (Brazil, Argentina, Mexico, Chile, Colombia, Uruguay, Peru). The search_products endpoint accepts a keyword query and site code and returns paginated product cards with title, price, seller, and rating. All endpoints return structured JSON with consistent field shapes.

Try it

site

Site code: MLB (Brazil), MLA (Argentina), MLM (Mexico), MLC (Chile), MCO (Colombia), MLU (Uruguay), MPE (Peru)

limit

Maximum number of results to return per page

query*

Search keyword

offset

Pagination offset (0-based)

→ api.parse.bot/scraper/5e07d074-2130-4ce4-9849-c6521eba3c6b/<endpoint>

Ready to send

Fill in the parameters and hit sign in to send to see live response data here.

Call it over HTTPgrab a free API key at signup

curl -X GET 'https://api.parse.bot/scraper/5e07d074-2130-4ce4-9849-c6521eba3c6b/search_products?query=samsung+galaxy' \
  -H 'X-API-Key: $PARSE_API_KEY'

Python SDK · recommended

Typed, relational, agent-ready

A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.

Fully typed · autocompletes
Objects link to objects
Typed errors & pagination

Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:

uv add parse-sdk
uv run parse init
uv run parse add --marketplace mercadolibre-com-api

uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.

"""Walkthrough: MercadoLibre SDK — browse deals, categories, and reviews."""
from parse_apis.mercadolibre_scraper_api import MercadoLibre, Site, ProductNotFound

client = MercadoLibre()

# Browse current deals on the Brazilian site
for deal in client.deals.list(site=Site.MLB, limit=3):
    print(deal.title, deal.price, deal.original_price)

# List all top-level categories with subcategories
category = client.categories.list(site=Site.MLB, limit=1).first()
if category:
    print(category.name, category.url)
    for sub in category.subcategories:
        print(f"  - {sub.name}: {sub.url}")

# Fetch product reviews by URL
try:
    reviews = client.reviewpages.get(
        url="https://www.mercadolivre.com.br/apple-iphone-15-128-gb-azul-distribuidor-autorizado/p/MLB1027172667"
    )
    print(reviews.average_rating, reviews.total_reviews)
    for review in reviews.reviews[:3]:
        print(review.stars, review.date, review.content[:80] if review.content else "")
except ProductNotFound as exc:
    print(f"Product not found: {exc}")

print("exercised: deals.list / categories.list / reviewpages.get")

All endpoints · 5 totalmissing one? ·

Search for products by keyword with support for pagination and site selection. Returns product cards with title, price, image, seller, and rating.

Input

Param	Type	Description
site	string	Site code: MLB (Brazil), MLA (Argentina), MLM (Mexico), MLC (Chile), MCO (Colombia), MLU (Uruguay), MPE (Peru)
limit	integer	Maximum number of results to return per page
queryrequired	string	Search keyword
offset	integer	Pagination offset (0-based)

Response

{
  "type": "object",
  "fields": {
    "query": "string",
    "results": "array",
    "next_offset": "integer|null",
    "total_results": "integer"
  },
  "sample": {
    "data": "{\"query\": \"samsung galaxy\", \"total_results\": 48, \"results\": [{\"title\": \"Smartphone Samsung Galaxy A32 128gb Preto\", \"url\": \"https://click1.mercadolivre.com.br/mclics/clicks/external/MLB/count?a=9wV%2Bqd8T0sd7lYogBVN%2BAtG309pUSScH1dSKllWbYfcMawsc4E0XRtFmj7sdM3bruXIbb7jEiE3w9M9sTRC2ZzeJQyxyHOxs3uxxwR0OejpJ%2FXCM%2FtR%2BhWlmbj9Zp72fGMbNu3HuRUOsaWUEBlHsVPqPeSdeLt0zdrLMwwSAxORoylLQPbXtW2jDUqAvzrJLanlw5A5fgzulJcmXqw5txxb2HY63rWSHTupS0mzkamuDou2x6GrQlJbk%2BRzgco8kj47xgi3xuSdoyUIq3CyMpKFhR0ZQ14R3oUMT0KL6g5hLD1BejjFqr%2FSQV6Q%2Bu%2FGiKvB3KiD%2FK4J7U2BcsidKpLPnAjq1AafsOrNv2%2BIZVye364C56JebBPTXh5DRCg%2BP%2BKv4G0NyFCzrXlCnTBW7aZMdrD2F4WPQ%2BTD6brLywb5rLBDvLJU%2B8gWVQelZCrE4WiUc4cqpVcmzxTpSZMSkHzBD%2FedGcgC9U%2F0BymspQALYvE%2BqMihtH7jpEz%2FHooGGxZUqD36XbdFmmp46RGZol%2BWy3%2Fd3yEY4Cyl0VsITqrEZbpMXMy8FhavndLiAHdqDploCzST1s2FeJaioqmFDAll3hvEb3PwMbI4lO0XWJUC24Z%2Bsd%2Bt21UNDKeaR65bWvCrRasP8jxlbFJ7vp7S8P3v942iMoVY87dUAfOwClHQ%2FZZJQL1MzSkeRZd27MD%2FHqd6xi6jDQC94R2YguVXb0lzd4mdO3AmTsh1UQ6jZr54yomOnTbR08xZsIhI4%2FZF2KeRf7mE9Dc9Dmv%2BqyTa9oBE5wjqfRBB773RDvDZOhPj0MDfuz030TDWfrZ39NkEcVoQcJb8LEwboLAFMfZqWh7O3xQw0EKXR0g%3D%3D&searchVariation=189360926695#polycard_client=search-desktop&is_advertising=true&searchVariation=189360926695&search_layout=grid&position=1&type=pad&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961\", \"price\": 706.19, \"original_price\": null, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_844804-MLB88798066516_082025-E.webp\", \"seller\": null, \"rating\": null}, {\"title\": \"Samsung Galaxy S26, 512gb, 12gb, Galaxy Ai, C\\u00e2mera Tripla Azul\", \"url\": \"https://www.mercadolivre.com.br/samsung-galaxy-s26-512gb-12gb-galaxy-ai-cmera-tripla-azul/p/MLB65560100#polycard_client=search-desktop&search_layout=grid&position=2&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB4484615031&sid=search\", \"price\": 6749.0, \"original_price\": 9099.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_741187-MLA106907945892_022026-E.webp\", \"seller\": \"Samsung\", \"rating\": null}, {\"title\": \"Celular Samsung Galaxy A26 5g 256gb, 8gb Ram, C\\u00e2mera De 50mp, Ip67, Tela Super Amoled 6.7 , Nfc - Preto\", \"url\": \"https://www.mercadolivre.com.br/celular-samsung-galaxy-a26-5g-256gb-8gb-ram-cmera-de-50mp-ip67-tela-super-amoled-67-nfc-preto/p/MLB47424244#polycard_client=search-desktop&search_layout=grid&position=3&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB4256561991&sid=search\", \"price\": 1439.0, \"original_price\": 2165.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_792472-MLA100025549859_122025-E.webp\", \"seller\": \"Vikings\", \"rating\": \"4.8\"}, {\"title\": \"Samsung Galaxy Z Flip7 FE 128GB 8GB RAM Tela 6,7\\\" AI Preto\", \"url\": \"https://www.mercadolivre.com.br/samsung-galaxy-z-flip7-fe-128gb-8gb-ram-tela-67-ai-preto/p/MLB52056868#polycard_client=search-desktop&search_layout=grid&position=4&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB5528348198&sid=search\", \"price\": 3494.0, \"original_price\": 6599.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_658650-MLA99455305250_112025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Celular Samsung Galaxy A56 5g 128gb 8gb Ram Preto\", \"url\": \"https://www.mercadolivre.com.br/celular-samsung-galaxy-a56-5g-128gb-8gb-ram-preto/p/MLB47115035#polycard_client=search-desktop&search_layout=grid&position=5&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB4002727935&sid=search\", \"price\": 1799.0, \"original_price\": 2999.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_638445-MLA100187155155_122025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Celular Samsung Galaxy A07 256gb, 8gb, C\\u00e2mera 50mp, Tela 6.7 , Prote\\u00e7\\u00e3o Ip54, Processador 6nm - Preto\", \"url\": \"https://www.mercadolivre.com.br/celular-samsung-galaxy-a07-256gb-8gb-cmera-50mp-tela-67-proteco-ip54-processador-6nm-preto/p/MLB54961556#polycard_client=search-desktop&search_layout=grid&position=6&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB4315493865&sid=search\", \"price\": 900.71, \"original_price\": 1299.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_895724-MLA91526198522_092025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Celular Samsung Galaxy S25 Fe 5g, 128gb, 8gb Ram, C\\u00e2mera Tripla De 50+12+8, Tela Grande De 6.7 Jetblack\", \"url\": \"https://www.mercadolivre.com.br/celular-samsung-galaxy-s25-fe-5g-128gb-8gb-ram-cmera-tripla-de-50128-tela-grande-de-67-jetblack/p/MLB61692896#polycard_client=search-desktop&search_layout=grid&position=7&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB6064285882&sid=search\", \"price\": 2788.0, \"original_price\": 4499.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_840870-MLA96785958150_112025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Smartphone Samsung Galaxy A36 5G 256GB 8GB RAM\", \"url\": \"https://www.mercadolivre.com.br/smartphone-samsung-galaxy-a36-5g-256gb-8gb-ram/p/MLB47111905#polycard_client=search-desktop&search_layout=grid&position=8&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB5317478858&sid=search\", \"price\": 1610.0, \"original_price\": 2999.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_645152-MLA99943507023_112025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Celular Samsung Galaxy A07 128gb, 4gb, C\\u00e2mera 50mp, Tela 6.7 , Prote\\u00e7\\u00e3o Ip54, Processador 6nm - Verde\", \"url\": \"https://www.mercadolivre.com.br/celular-samsung-galaxy-a07-128gb-4gb-cmera-50mp-tela-67-proteco-ip54-processador-6nm-verde/p/MLB55027908#polycard_client=search-desktop&search_layout=grid&position=9&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB4276106547&sid=search\", \"price\": 643.9, \"original_price\": 899.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_712741-MLA96423997982_102025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Celular Samsung Galaxy A56 5g 256gb 8gb Ram Rosa\", \"url\": \"https://www.mercadolivre.com.br/celular-samsung-galaxy-a56-5g-256gb-8gb-ram-rosa/p/MLB47112282#polycard_client=search-desktop&search_layout=grid&position=10&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB4002722025&sid=search\", \"price\": 2288.0, \"original_price\": 3699.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_685573-MLA99583115040_122025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Samsung Galaxy Z Flip7 5G 256GB 12GB RAM, Galaxy AI Preto\", \"url\": \"https://www.mercadolivre.com.br/samsung-galaxy-z-flip7-5g-256gb-12gb-ram-galaxy-ai-preto/p/MLB53044618#polycard_client=search-desktop&search_layout=grid&position=11&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB5517025778&sid=search\", \"price\": 6299.0, \"original_price\": 8199.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_784231-MLA99948073837_112025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"5.0\"}, {\"title\": \"Samsung Galaxy S25 5G, 256GB, 12GB, C\\u00e2mera Tripla - Verde claro\", \"url\": \"https://www.mercadolivre.com.br/samsung-galaxy-s25-5g-256gb-12gb-cmera-tripla-verde-claro/p/MLB45502235#polycard_client=search-desktop&search_layout=grid&position=12&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB5264351126&sid=search\", \"price\": 3897.0, \"original_price\": 5999.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_679792-MLA99986227831_112025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Celular Samsung Galaxy A17 Com Ia, 128gb, 4gb Ram, C\\u00e2m De 50mp, Tela De 6.7 , Nfc, Ip54 - Azul\", \"url\": \"https://www.mercadolivre.com.br/celular-samsung-galaxy-a17-com-ia-128gb-4gb-ram-cm-de-50mp-tela-de-67-nfc-ip54-azul/p/MLB54986607#polycard_client=search-desktop&search_layout=grid&position=13&type=product&tracking_id=40f4b348-c986-4578-82e9-8159a5c3f961&wid=MLB4217282117&sid=search\", \"price\": 1078.0, \"original_price\": 1499.0, \"image\": \"https://http2.mlstatic.com/D_Q_NP_2X_907031-MLA99504284188_112025-E.webp\", \"seller\": \"Samsung\", \"rating\": \"4.9\"}, {\"title\": \"Celular Samsung Galaxy A16 128gb 4gb Ram C\\u00e2mera 50mp Tela 6....",
    "status": "success",
    "_truncated": "Use get_full_output(test_index=12) for complete data."
  }
}

About the MercadoLibre API

Product Search and Detail

The search_products endpoint accepts a query string plus an optional site code — MLB for Brazil, MLA for Argentina, MLM for Mexico, MLC for Chile, MCO for Colombia, MLU for Uruguay, or MPE for Peru. Results include total_results, a next_offset for pagination, and a results array of product cards each carrying title, price, image, seller, and rating. Pagination is controlled via the offset and limit parameters.

For deeper product data, get_product_details takes a full product page URL and returns title, price, original_price (when a discount exists), images array, attributes object (specs like brand, model, color), stock_info, shipping, seller object, and a description string. This is the endpoint to use when you need specifications beyond the summary card.

Reviews and Category Data

get_product_reviews works against MercadoLibre catalog product URLs. Each call returns up to 15 review objects, each with content, date, and stars fields, alongside average_rating and total_reviews as text strings (e.g. '50.434 avaliações'). Products with very few reviews may return metadata but an empty reviews array — this is expected behavior for low-review items.

get_category_list returns the full top-level category tree for a given site, with each category object containing name, url, and a subcategories array. The get_offers_deals endpoint pulls from the site's Ofertas section and returns up to approximately 54 promoted product cards per call, each including title, url, price, original_price, image, seller, and rating — useful for tracking discount depth and promotional activity without a search query.

Reliability & maintenanceVerified 4d ago

The MercadoLibre API is a managed, monitored endpoint for mercadolibre.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when mercadolibre.com 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 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.

Last verified

4d ago

Latest check

3/3 endpoints passing

Maintenance

Monitored & self-healing

Will this API break when the source site changes?+

It's built not to. Every endpoint is health-checked on a schedule with automated test probes. When the source site changes and a check fails, the API is automatically queued for repair and re-verified — that's the self-healing layer. Each API page shows when its endpoints were last verified. And because marketplace APIs are shared, any fix reaches everyone using it.

Is this an official API from the source site?+

No — Parse APIs are independent, managed REST wrappers over publicly available data. That is the point: where a site has no official API (or only a limited one), Parse gives you a maintained, monitored endpoint for that data and keeps it working as the site changes — so you get a stable contract over a source that never promised one.

Can I fix or extend this API myself if I need a new endpoint or field?+

Yes — and you don't have to wait on us. This API was generated by the Parse agent, which stays attached. Describe the change in plain English ("add an endpoint that returns reviews", "fix the price field") in the revise box on the API page or via the revise_api MCP tool, and the agent rebuilds it against the live site in minutes. Contributing the change back to the public API is free.

What happens if I call an endpoint that has an issue?+

Errors are machine-readable: a bad call returns a clean status with the list of available endpoints and a repair hint, so an agent (or you) can recover or trigger a fix instead of failing silently. Confirmed failures feed the automatic repair queue.

Common use cases

Track price changes and discount depth on promoted items using get_offers_deals across multiple country sites
Build a cross-market price comparison tool using search_products with different site codes for the same keyword
Aggregate customer sentiment by pulling reviews, stars, and average_rating fields for a set of product URLs
Map MercadoLibre's full category hierarchy per country using get_category_list to structure a product taxonomy
Monitor stock and seller information for specific listings by polling get_product_details on tracked URLs
Extract product attributes such as brand, model, and specs from the attributes object in get_product_details for catalog enrichment
Identify top-rated products in a search using the rating field returned by search_products

Pricing & limitsSee full pricing →

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	100 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.

Frequently asked questions

Does MercadoLibre have an official developer API?+

Yes. MercadoLibre operates an official public API at https://developers.mercadolibre.com. It requires OAuth 2.0 registration and covers order management, payments, and seller operations. The Parse API covers the public-facing product, review, category, and deals data without requiring OAuth credentials.

What does `get_product_reviews` return, and are all review counts accessible?+

Each call returns up to 15 review objects, each with content, date, and stars, plus average_rating and total_reviews as text. Products with very few reviews may return average_rating and total_reviews but an empty reviews array. There is no cursor or page parameter to retrieve reviews beyond the first 15 per request.

Which country sites are supported, and is there coverage for other Latin American markets?+

Seven site codes are supported: MLB (Brazil), MLA (Argentina), MLM (Mexico), MLC (Chile), MCO (Colombia), MLU (Uruguay), and MPE (Peru). Markets such as Bolivia, Ecuador, Panama, and others that MercadoLibre operates in are not currently covered. You can fork the API on Parse and revise the site parameter handling to add support for additional market codes.

Does the API return seller performance metrics or feedback scores?+

The get_product_details endpoint returns a seller object with seller identity information, and search_products includes a seller field on each product card. Detailed seller reputation scores, transaction history, or feedback percentages are not currently returned. You can fork the API on Parse and revise it to add a dedicated seller-detail endpoint that captures those metrics.

How does pagination work in `search_products`?+

The endpoint returns total_results and a next_offset integer (or null when no further pages exist). Pass the next_offset value back as the offset parameter on the next call, and use limit to control how many results are returned per page. The offset parameter is 0-based.

Page content last updated June 11, 2026. Spec covers 5 endpoints from mercadolibre.com.

Related APIs in MarketplaceSee all →

mercadolibre.com.mx API

Search for products on Mercado Libre Mexico, view detailed product information with pricing and offers, browse categories, and research seller details all in one place. Access live marketplace data including product listings, category hierarchies, and current offers to help you find and compare items across Mexico's largest e-commerce platform.

mercadolibre.com.ar API

Search for products, cars, and real estate listings on MercadoLibre Argentina and access detailed information including product specifications, customer reviews, and seller profiles. Get comprehensive market data to compare prices, evaluate sellers, and make informed purchasing decisions across multiple categories.

lista.mercadolivre.com.br API

Search and browse products from Mercado Livre Brazil, view detailed pricing and offers, and explore categories to find daily deals and product information. Get comprehensive product details including specifications and current market offers all in one place.

mercadolivre.com.br API

tiendamia.com API

Search for products across multiple countries and vendors on Tiendamia, then access detailed product information, best sellers, outlet deals, and weekly promotions. Get real-time pricing and availability data to find the best deals across different markets.

jp.mercari.com API