MercadoLibre Scraper — Mercado Livre, Argentina, Mexico and six more countries

Scrape MercadoLibre and Mercado Livre products by search, search link or product link, on eight sites: Argentina, Brazil, Mexico, Chile, Peru, Uruguay, Ecuador and Venezuela. Every result comes with its price, original price and discount, installments, shipping (free, FULL, international), rating and number of ratings, brand and link. Turn on product details to also get each product's sold count, units in stock, condition, every variant (colors, sizes, memory…) with what is out of stock, the seller with its MercadoLíder level and sales, shipping promises, every specification, the description, all photos and the category path.

No login, no API key, no browser to configure: paste what you would type in MercadoLibre's search box, or the links you already have.

What you can use it for

• Price monitoring and competitor tracking across MercadoLibre countries: run the same searches on a schedule and compare prices, discounts and installments.
• Market research: how many sellers offer a product, at what prices, with which shipping, and which ones sell the most (sold counts and seller sales with product details).
• Catalog and assortment analysis: every variant, specification and category of the products you follow.
• Lead lists of sellers: official stores and MercadoLíder sellers of a category.

Input

Field	What it does
Searches	Words as you would type them on MercadoLibre: auriculares bluetooth, iphone 15, tênis nike.
Country	The site the searches run on: AR, BR, MX, CL, PE, UY, EC or VE. Links carry their own country.
Sort / Condition	Most relevant, lowest or highest price; any, new or used — for the searches above.
Search links	Any MercadoLibre search link, with every filter it carries (price range, brand, shipping, category…). Set the filters on the site and paste the address bar.
Product links	Classic links (articulo.mercadolibre.com.ar/MLA-…, produto.mercadolivre.com.br/MLB-…), catalog links (…/p/MLA45765721), seller-product links (…/up/MLAU…) or a bare item id (MLA2815639876). Always read with their details.
Include product details	Read each search result's own page too (one extra page per product, priced as a product with details).
Max products per search	Stop each search after this many products (default 100; 0 = every page MercadoLibre shows, about 2,000). Checked before any request.

{
    "searches": ["auriculares bluetooth"],
    "country": "AR",
    "sort": "price_asc",
    "condition": "new",
    "maxItemsPerSearch": 200,
    "includeDetails": true
}

Output

One row per product. Example (with details, shortened):

{
    "status": "ok",
    "site": "AR",
    "input": "zapatillas",
    "position": 2,
    "itemId": "MLA2815639876",
    "productId": null,
    "userProductId": null,
    "url": "https://articulo.mercadolibre.com.ar/MLA-2815639876-zapatillas-skate-oversize-clasicas-livianas-_JM",
    "title": "Zapatillas Skate Oversize Clasicas Livianas",
    "price": 49554.62,
    "originalPrice": 71999,
    "discountPercent": 31,
    "currency": "ARS",
    "installments": "Cuota promocionada en 6 cuotas de $ 9.645,81",
    "shipping": "Llega gratis mañana",
    "freeShipping": true,
    "fulfilledByMercadoLibre": true,
    "rating": 4.5,
    "reviewCount": 377,
    "brand": "Vurt",
    "details": {
        "condition": "Nuevo",
        "soldText": "+1000 vendidos",
        "soldQuantity": 1000,
        "stockText": "(+25 disponibles)",
        "availableQuantity": 25,
        "seller": { "name": "VURT", "officialStore": false, "level": "MercadoLíder Platinum", "salesText": "+5 mil ventas", "sales": 5000 },
        "variations": [{ "name": "Talle", "selected": null, "options": [{ "label": "35 AR", "id": null, "selected": false, "available": true }] }],
        "specs": [{ "name": "Marca", "value": "Vurt" }, { "name": "Modelo", "value": "Skate" }],
        "description": "¡SOMOS VURT!\nFábrica nacional…",
        "images": ["https://http2.mlstatic.com/D_NQ_NP_…-F.jpg"],
        "categories": ["Ropa y Accesorios", "Calzado", "Zapatillas", "Zapatillas Skate"]
    }
}

Field	Meaning
itemId / productId / userProductId	The item for sale (MLA…), the catalog product it is sold under (/p/MLA…) and the seller's product grouping its variants (/up/MLAU…).
price, originalPrice, discountPercent, currency	As MercadoLibre shows them; Brazil's cards show the Pix price. Ecuador and Venezuela price in USD.
installments, shipping, freeShipping, fulfilledByMercadoLibre, internationalFrom	Payment and delivery as the result shows them.
rating, reviewCount	Average stars and how many ratings they average.
brand, label, variationsText, coupon	What the card shows under the title, its highlight ("MÁS VENDIDO"), "Available in 3 colors", and a coupon.
details.soldQuantity, details.availableQuantity	Lower bounds as MercadoLibre gives them ("+1000 vendidos" is 1000, "+25 disponibles" is 25).
details.seller	Name, store link, official store, MercadoLíder level and sales.
details.variations	Every picker with its options, the chosen one, and available: false for what is out of stock.

A search or link that gives no product returns one free row with status (no_results, not_found, blocked, unreadable or invalid) and the reason, so you always know what happened to each line of your input.

Pricing

Pay per result, nothing per run:

• US$0.001 per product from a search (US$1 per 1,000).
• US$0.003 per product with details (its own page read), and for every product link.
• Free: searches without results, links that do not exist, pages MercadoLibre would not serve, invalid input.

Set a maximum cost per run in Apify and the Actor stops before reading anything it could not charge.

Limits and good to know

• MercadoLibre serves about 2,000 results per search (42 pages of 48). For a larger market, split it into narrower searches, price ranges or categories with search links.
• The counts MercadoLibre shows are rounded: "+9.999 resultados", "+5 mil vendidos". The Actor gives the number and the text as written.
• A category's landing page shows only featured products; to get all of a category, search inside it and paste that link.
• Prices are those shown to a visitor of that country, without a logged-in account or a delivery address.
• Colombia is not available: mercadolibre.com.co answers a JavaScript bot challenge to every visit, and this Actor does not solve challenges. A Colombian link returns a free invalid row saying so.

Is it legal?

The Actor reads public product pages, the same a visitor sees without logging in, and no personal data beyond what a seller publishes for its store. Check MercadoLibre's terms and your local law for your use, especially before republishing content.