Mercado Libre Scraper — Products, Prices, Sellers & Ratings to JSON

Scrape Mercado Libre search results into clean, structured JSON — across Mexico, Argentina, Brazil, Chile, Colombia, Peru and Uruguay. Give it search terms, get back every product with its clean product URL, price, discount, rating, review count, seller and shipping — ready for price monitoring, market research and lead generation.

AI-agent ready: this Actor is callable and payable by AI agents via x402 (USDC on Base), no Apify account required.

Unlike most Mercado Libre scrapers, this Actor returns the real product permalink (not an ad‑tracking redirect) and the real star rating shown on the listing, and never charges you for empty, duplicate or failed results.

Who uses this

• 🛒 E‑commerce & repricing teams — monitor competitor prices and discounts across LatAm.
• 📊 Market researchers — analyze catalog depth, ratings and seller mix per category.
• 💼 Sellers & brands — benchmark against official stores and top sellers in your niche.
• 🤖 Data & AI pipelines — feed clean, structured product data into your models.
• 🧑‍💻 Developers — a reliable Mercado Libre endpoint by search term, no anti‑bot to handle.

Features

• 🌎 7 Latin American marketplaces — MX, AR, BR, CL, CO, PE, UY, from one input.
• 🔗 Clean permalinks — real articulo.mercadolibre.* product URLs, not click1…mclics tracking links.
• ⭐ Complete data — price, original price, discount %, star rating, seller, free‑shipping, installments, sponsored flag (review count included when Mercado Libre displays it on the listing).
• 📄 Full pagination — collect as many results per search term as you need.
• 💸 Fair billing — pay per product actually delivered; empty/blocked pages cost you nothing.
• 🧱 Stable output schema — documented, no debug fields.

Input

Field	Type	Description
targets	array of strings	Search terms (one search per term). Required.
country	string	mx, ar, br, cl, co, pe, uy. Required.
sortBy	string	relevance (default), price_asc, price_desc.
maxResults	integer	Max products per search term (50 per page). Default 100.
maxItems	integer	Optional global cap across all terms.

{
  "targets": ["laptop", "iphone 15"],
  "country": "mx",
  "sortBy": "relevance",
  "maxResults": 100
}

Output

Each dataset item (real fields produced by the Actor):

{
  "id": "MLM123456",
  "title": "MacBook Pro 14\" M3 8GB 1TB",
  "permalink": "https://articulo.mercadolibre.com.mx/MLM-123456-macbook",
  "currentPrice": 39999,
  "originalPrice": 49999,
  "currency": "MXN",
  "discountPercent": 20,
  "ratingValue": 4.7,
  "reviewCount": 1234,
  "sellerName": "Apple",
  "isOfficialStore": true,
  "freeShipping": true,
  "shippingText": "Llega gratis mañana",
  "installmentsText": "15 meses sin intereses",
  "categoryId": "MLM1652",
  "isSponsored": false,
  "site": "MLM",
  "country": "mx",
  "sourceTarget": "laptop",
  "pageNumber": 1,
  "searchRank": 1,
  "scrapedAt": "2026-07-11T00:00:00Z"
}

Pricing

Pay‑per‑result. A typical search of 1,000 products costs about $1.50–$2.00 total, billed only for products actually returned. Empty or blocked pages are never charged.

Use cases

• Price monitoring — track competitor prices and discounts across LatAm marketplaces.
• Market research — analyze catalog depth, ratings and seller mix per category.
• Lead generation — build lists of official stores and top sellers by niche.
• Repricing / e‑commerce ops — feed clean product data into your pricing tools.

FAQ

How do I scrape Mercado Libre product data into a spreadsheet? Run this Actor with your search terms and export the dataset to CSV, Excel or JSON from the Apify console or API.

Does it work for Mercado Libre Mexico, Argentina and Brazil? Yes — set country to mx, ar, br, cl, co, pe or uy.

Can I get the real product URL instead of a tracking link? Yes — the permalink field is the clean articulo.mercadolibre.* URL, stripped of tracking parameters.

Does it return review counts and ratings? Yes — both ratingValue and reviewCount are included when the listing shows them.

Will I be charged for failed runs? No. Billing happens per product delivered; blocked or empty pages cost nothing.

Which countries does it cover? Seven Mercado Libre marketplaces: Mexico (mx), Argentina (ar), Brazil (br), Chile (cl), Colombia (co), Peru (pe) and Uruguay (uy).

Can I monitor prices on a schedule? Yes — schedule the Actor (or its task) to run daily and export each run to build your own Mercado Libre price‑history dataset.

Limitations

• Search‑results scraping (listing pages). Full product‑detail pages (description, all photos, seller reputation history) are out of scope for v0.1.
• Mercado Libre serves anti‑bot challenges to some traffic; the Actor uses residential proxies and skips (never charges for) any page that is challenged.

Support

Found a missing field or a bug? Open an issue on the Actor's Issues tab — we respond within 48h.