MercadoLivre Official Store Scraper

Extract all products from any official Mercado Livre store in Brazil, with price, rating, discounts, badges, FULL status, shipping and seller details.

---

ℹ️ Bring your own proxy Mercado Livre serves store catalogues only to requests that clear its validation, so this Actor needs a proxy with anti-blocking support, supplied in the customProxyUrl field. Providers offer this capability under names such as stealth, unblocking or scraping browser; any of them works, and the Actor is not tied to a particular one.

A run without one stops in a few seconds with a clear message, so you are not charged for scraping time that would produce nothing.

---

Quick Start

{
  "storeUrl": "3m",
  "customProxyUrl": "http://user:password@proxy.example.com:8080"
}

Find stores: Browse all official stores at mercadolivre.com.br/lojas-oficiais and copy the store slug from the URL.

More examples

---

Features

Feature	Description
Any Official Store	Supports any Mercado Livre official store (3M, Samsung, Nike, etc.)
Complete Product Data	Price, rating, sales, badges, coupons, FULL, shipping, seller, and more
Real-Time Data	Fresh data directly from Mercado Livre platform
Structured JSON Output	Clean, validated data ready for analysis

---

Use Cases

• E-commerce and product research: monitor every product in an official store, track pricing, and identify bestsellers
• Competitor analysis: compare pricing strategy and FULL fulfilment across stores
• Price monitoring: run periodically to detect price changes and new discounts
• Market intelligence: analyse badges, ratings and discount depth across a catalogue

---

Input Parameters

Parameter	Type	Default	Description
storeUrl	string	none	Required. Store URL or slug (e.g. 3m, samsung)
customProxyUrl	string	none	Required. Your proxy with anti-blocking support
maxPages	integer	0	Max pages to read. 48 products per page. 0 = all pages
maxItems	integer	0	Max products to extract. 0 = all products
requestDelay	number	3.0	Delay between page requests, in seconds (0.5-10.0)

A catalogue page takes roughly 30 to 60 seconds to retrieve through an anti-blocking proxy, and a large store can run to 25 pages or more. Use maxPages or maxItems when you only need a sample.

---

Output Example

[
  {
    "item_id": "MLB4265194944",
    "product_id": "MLB27389460",
    "title": "Electrolux Filtro de Água Refil Acqua Pure para Purificador PE12",
    "price": 147.98,
    "original_price": 195.99,
    "currency": "BRL",
    "discount": "24% OFF",
    "seller_store": "abc-eletropecas",
    "seller_name": "ABC ELETROPEÇAS",
    "badge": "MAIS VENDIDO",
    "is_full": false,
    "shipping": "Frete grátis",
    "url": "https://www.mercadolivre.com.br/electrolux-filtro-de-agua-refil-acqua-pure...",
    "thumbnail": "https://http2.mlstatic.com/D_Q_NP_2X_675440-MLA116699071891_082026-E.webp",
    "rating": 4.9,
    "scraped_at": "2026-09-08T18:16:52.464748+00:00"
  }
]

Note: Fields original_price, discount, badge, coupon, and seller_name appear only when available for the product.

---

Data Fields

Field	Type	Description
item_id	string	Unique item ID
product_id	string	Catalog ID (/p/MLBXXX), when available
title	string	Product title
price	number	Final price in BRL
original_price	number	Original price before discount
currency	string	Currency code (BRL)
discount	string	Discount text (e.g., "18% OFF")
seller_store	string	Store slug (e.g., "3m", "samsung")
seller_name	string	Brand/seller name (e.g., "3M", "SCOTCH-BRITE")
badge	string	Highlight badge (MAIS VENDIDO, RECOMENDADO)
coupon	string	Coupon info (e.g., "Cupom 10% OFF")
is_full	boolean	Whether the product has Mercado Livre FULL fulfillment
shipping	string	Shipping info (e.g., "Frete gratis")
url	string	Direct product page URL
thumbnail	string	Product image URL
rating	number	Customer rating (1.0 to 5.0)
sold_quantity	string	Sales count text (e.g., "+10mil", "+1000")
scraped_at	string	ISO 8601 timestamp in UTC

---

Integrations

Use the API tab on the Actor page to get ready-to-use code examples in Python, JavaScript, and cURL. The examples are auto-generated with the correct parameters for immediate integration.

---

Example Store URLs

Store	URL
3M	https://www.mercadolivre.com.br/loja/3m
Samsung	https://www.mercadolivre.com.br/loja/samsung
Nike	https://www.mercadolivre.com.br/loja/nike

Browse all official stores at mercadolivre.com.br/lojas-oficiais.

---

FAQ

---

Support

1. Check the FAQ above for common solutions
2. Test with a small run by setting maxPages to 1
3. Contact support through Apify for additional assistance