Yes. The Free tier on Parse includes 100 API calls per month at no cost with a 5 request-per-minute rate limit. Paid tiers add more credits and higher rate limits: Hobby ($30/month, 1,000 credits, 20 req/min) and Developer ($100/month, 5,000 credits, 250 req/min).

What are the rate limits?

Rate limits are per Parse account, not per API: 5 requests/minute on Free, 20 on Hobby, and 250 on Developer. Exceeding the limit returns a 429 status code. The same limit applies regardless of which marketplace API you call.

How do I authenticate?

Send your Parse API key in the X-API-Key header on every request. Get a key by signing up at parse.bot — no credit card required for the free tier.

Discover/mercadolibre.com API

live

mercadolibre.com APImercadolibre.com ↗

Access MercadoLibre/MercadoLivre product listings, reviews, categories, and deals across 7 Latin American countries via a single REST API.

Marketplace ecommerce reviews ratings

Endpoints

Updated

10d ago

Try it

site

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

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.

Use it in your codegrab 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'

All endpoints · 5 totalclick to expand

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.com API

This API provides 5 endpoints for extracting product data, customer reviews, category trees, and promotional deals from MercadoLibre across 7 Latin American markets. Use search_products to query listings by keyword and receive titles, prices, seller info, and ratings. Use get_product_reviews to pull up to 15 reviews per request along with aggregate star ratings. All endpoints support a site parameter to target Brazil, Argentina, Mexico, Chile, Colombia, Uruguay, or Peru.

Product Search and Details

The search_products endpoint accepts a required query string and an optional site code (e.g., MLB for Brazil, MLA for Argentina, MLM for Mexico). Results include title, price, image, seller, and rating fields per product card, plus a total_results count and next_offset for pagination. The get_product_details endpoint takes a full product page URL and returns richer fields: attributes (a key-value object of product specifications), images (array), stock_info, description, shipping, and original_price when a discount is present.

Reviews and Ratings

get_product_reviews expects a catalog product URL and returns up to 15 review objects per call. Each review object includes content, date, and stars. The endpoint also surfaces average_rating and total_reviews as top-level fields. Products with very few reviews may return metadata but an empty reviews array. Review counts are returned as locale-formatted strings (e.g., '47.939 avaliações') reflecting the source's regional formatting.

Categories and Deals

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 — useful for building navigation or seeding category-level crawls. get_offers_deals retrieves up to approximately 54 promoted product cards from the Ofertas section, each with title, url, price, original_price, image, seller, and rating. Both endpoints accept the same optional site parameter as the search endpoint.

Common use cases

Track price changes on specific product URLs across Argentina, Brazil, and Mexico using get_product_details.
Aggregate competitor reviews by collecting stars, content, and date fields from get_product_reviews across catalog listings.
Monitor daily deal discounts by comparing price vs original_price from get_offers_deals for a given market.
Build a category-aware product crawler by seeding URLs from get_category_list subcategories.
Compare search ranking position and pricing across country sites by running the same query with different site codes.
Enrich product data pipelines with seller information and shipping availability from get_product_details.
Identify top-rated listings in a category by sorting search_products results on the rating field.

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

Frequently asked questions

Does MercadoLibre have an official developer API?+

Yes. MercadoLibre maintains an official REST API documented at https://developers.mercadolibre.com. It requires OAuth registration and has its own access tiers. The Parse API covers different data surfaces — including reviews and promotional deals — without requiring OAuth credentials from your application.

What does `get_product_reviews` return when a product has very few reviews?+

The endpoint returns average_rating and total_reviews as metadata fields when they are available, but the reviews array will be empty if the product has too few reviews to populate the reviews modal. You should treat an empty reviews array as a valid response rather than an error.

Can the API return seller performance metrics or full seller profiles?+

Not currently. The get_product_details and search_products endpoints expose a seller object that identifies the seller, but detailed seller metrics such as reputation score, completed transaction counts, or response times are not included. You can fork this API on Parse and revise it to add a dedicated seller details endpoint.

Is there a way to paginate through more than 54 deals from `get_offers_deals`?+

The get_offers_deals endpoint returns up to approximately 54 promoted product cards in a single response and does not currently support pagination or offset parameters. The search_products endpoint, by contrast, supports limit and offset for paginated traversal. If deeper offers pagination is required, you can fork the API on Parse and revise it to add that capability.

How are prices and review counts formatted across different country sites?+

Prices are returned as numbers in the currency of the selected site (e.g., BRL for MLB, ARS for MLA). Review counts come back as locale-formatted strings matching the source's regional conventions, such as '47.939 avaliações' for Brazilian Portuguese. Your parsing logic should handle string-format numbers with period or comma separators depending on the locale.

Page content last updated May 21, 2026. Spec covers 5 endpoints from mercadolibre.com.