MercadoLibre Product & Seller Scraper

Search MercadoLibre / Mercado Livre across Latin America and turn the results into clean, structured product data — title, price, discount, seller/store, star rating, shipping and images. Or paste product links to pull full detail for each item. Works across Brazil, Argentina, Mexico, Chile, Colombia, Peru, Uruguay and Ecuador.

Why use this actor

• No account, no login, no API key — pick a country, type a keyword, and run.
• All of LATAM in one actor — one input switch chooses the country storefront; the right region is used automatically so prices and availability are local and accurate.
• Two ways to pull data — search by keyword for a whole results list, or fetch full detail (condition, units sold, rating, all images, description) from specific product links.
• Real pricing — current price, the original (pre-discount) price, and the currency exactly as shown.
• Stable JSON output ready for spreadsheets, databases, dashboards or price-tracking pipelines. Export to JSON, CSV or Excel.
• Handles blocks automatically and retries — no scrapers or browsers to babysit.

How it works

1. Choose a country site (e.g. Brazil) and a mode.
2. In search mode, type a keyword (like notebook or iphone 15); the actor walks the results pages and returns one row per product.
3. In detail mode, paste one or more product URLs; the actor opens each page and reads the full detail.
4. Results stream into your dataset, ready to download or feed into another tool.

You don't manage any of the fetching, retries or blocking — just the keyword or the links you care about.

Input

Search mode (find products by keyword):

{
    "mode": "search",
    "site": "MLB",
    "query": "notebook",
    "maxItems": 48,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Detail mode (full detail from product links):

{
    "mode": "detail",
    "site": "MLB",
    "productUrls": [
        "https://produto.mercadolivre.com.br/MLB-3847742125"
    ],
    "maxConcurrency": 3,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Field	Type	Description
mode	string	"search" (default) — find products by keyword. "detail" — fetch full detail from productUrls.
site	string	Country storefront: MLB Brazil, MLA Argentina, MLM Mexico, MLC Chile, MCO Colombia, MPE Peru, MLU Uruguay, MEC Ecuador.
query	string	Search keyword (search mode). Example: notebook, iphone 15, tenis nike.
productUrls	array	Product page URLs to extract (detail mode).
maxItems	integer	Max products to return in search mode. Default: 48.
maxConcurrency	integer	How many product pages to fetch in parallel in detail mode. Default: 3.
proxyConfiguration	object	Residential proxy required. The country is matched to the chosen site automatically.

Output

Search mode

One record per product. Real sample from a live run (site: MLB, query: "iphone 15"):

{
    "_input": "iphone 15",
    "_source": "search-html",
    "_scrapedAt": "2026-07-15T18:14:56Z",
    "itemId": "MLB1027172669",
    "title": "Apple iPhone 15 (256 GB) - Preto - Distribuidor Autorizado",
    "price": 4859,
    "currency": "R$",
    "originalPrice": 8095,
    "seller": "Apple",
    "rating": "4.9",
    "reviews": null,
    "shipping": "Chegará grátis amanhã",
    "image": "https://http2.mlstatic.com/D_Q_NP_2X_841858-MLA95934002967_102025-E.webp",
    "productUrl": "https://produto.mercadolivre.com.br/MLB-1027172669",
    "permalink": "https://www.mercadolivre.com.br/apple-iphone-15-256-gb-preto-distribuidor-autorizado/p/MLB1027172669",
    "site": "MLB"
}

Field	Type	Description
itemId	string	MercadoLibre item ID (e.g. MLB1027172669).
title	string	Product title.
price	number	Current price as a number.
currency	string	Currency symbol shown on the page (e.g. R$, $).
originalPrice	number | null	Original price before discount, when the listing shows one.
seller	string | null	Seller or official store name, when shown.
rating	string | null	Average star rating, when shown.
reviews	string | null	Number of reviews, when shown on the card.
shipping	string | null	Shipping label (e.g. Frete grátis, Chegará grátis amanhã).
image	string	Product thumbnail.
productUrl	string	Clean canonical product URL (use this to feed detail mode).
permalink	string	The exact link from the results page.
site	string	The country site the result came from.

Detail mode

One record per product URL. Real sample from a live run:

{
    "_input": "https://produto.mercadolivre.com.br/MLB-3847742125",
    "_source": "detail-html",
    "_scrapedAt": "2026-07-15T18:13:51Z",
    "itemId": "MLB3847742125",
    "title": "Notebook Samsung Galaxy Book4 Intel® U300 (1.20 Ghz, até 4.4GHz, 8 MB L3 Cache), Windows 11 Home, 8GB, 256GB SSD, UHD Graphics, 15.6'' Full HD LED, 1.55kg",
    "price": 3038.99,
    "currency": "R$",
    "brand": "Samsung",
    "condition": "Novo",
    "availability": "https://schema.org/InStock",
    "seller": "Samsung",
    "soldText": "Novo  |  +50 mil vendidos",
    "rating": "4.9",
    "reviews": "(19059)",
    "images": [
        "https://http2.mlstatic.com/D_NQ_NP_2X_821317-MLA113071923402_072026-F.webp",
        "https://http2.mlstatic.com/D_NQ_NP_743004-MLA81858054218_012025-F.jpg",
        "... 8 more"
    ],
    "description": "Modelo do processador: Intel® Inside U300. | Linha do processador: Intel Inside. | Marca do processador: Intel. ...",
    "url": "https://produto.mercadolivre.com.br/MLB-3847742125"
}

Field	Type	Description
itemId	string	MercadoLibre item ID.
title	string	Full product title.
price	number	Current price as a number.
currency	string	Currency symbol or code.
brand	string | null	Brand, when listed.
condition	string | null	Item condition (e.g. Novo, Usado).
availability	string | null	Stock status.
seller	string | null	Seller or official store name.
soldText	string | null	Condition + units sold as shown (e.g. `Novo
rating	string | null	Average star rating.
reviews	string | null	Number of reviews.
images	array	Product image URLs (up to 10).
description	string | null	Product description / specs summary.
url	string	The product URL that was scraped.

Failed lookups never fail silently — they produce a record with _error and _errorDetail (e.g. not_found for a dead link) so nothing disappears from your dataset.

Notes & limits

• A Residential proxy is required. MercadoLibre blocks data-center connections; the actor uses a residential connection matched to the country you chose, which is what makes the local prices and availability accurate. This is prefilled — just press Run.
• Some fields depend on the listing. Sponsored search cards may not show a review count; those come back as null, while the rest of the record is complete. Use detail mode to get the full review count and description for a specific product.
• productUrl is the clean link. Some search results link through an ad tracker; the actor also gives you a clean productUrl built from the item ID — the best link to feed back into detail mode.
• For price tracking, schedule the actor (e.g. daily) with the same keyword or product list and keep each run's dataset — price and originalPrice over time give you a discount/price history.