MercadoLivre Official Store Scraper

Extract all products from any official Mercado Livre store in Brazil — with price, rating, sales count, badges, coupons, FULL status, shipping info, and more.

---

IMPORTANT — Proxy Required: This Actor requires Apify Residential Proxy to work on the Apify platform. Mercado Livre blocks all datacenter IPs — without RESIDENTIAL proxy, the scraper will return 0 results and your run will fail. Make sure your Apify plan includes Residential Proxy access before running this Actor. Proxy usage is billed separately to your Apify account.

---

Quick Start

{
  "storeUrl": "3m",
  "useApifyProxy": true,
  "proxyCountry": "BR",
  "proxyGroups": ["RESIDENTIAL"]
}

Tip: Use proxyCountry: "BR" to get prices in Reais and correct shipping info.

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 & Product Research — Monitor all products from official stores, track pricing, and identify bestsellers
• Competitor Analysis — Compare pricing strategy, coupon availability, and FULL fulfillment across stores
• Price Monitoring — Run periodically to detect price changes, new discounts, and promotional coupons
• Market Intelligence — Analyze MAIS VENDIDO and RECOMENDADO badges, ratings, and sales volumes

---

Input Parameters

Parameter	Type	Default	Description
storeUrl	string	—	Store URL or slug (e.g., 3m, samsung)
maxPages	integer	0	Max pages to scrape. 48 products per page. 0 = all pages
maxItems	integer	0	Max products to extract. 0 = all products
requestDelay	number	3.0	Delay between requests in seconds (0.5-10.0)
useApifyProxy	boolean	true	Required on Apify platform. Disable only for local execution
proxyCountry	string	"BR"	Proxy country code. Use BR for correct prices
proxyGroups	array	["RESIDENTIAL"]	Must be RESIDENTIAL. Mercado Livre blocks DATACENTER IPs

Proxy is REQUIRED on Apify platform. Mercado Livre blocks all datacenter IPs. Without RESIDENTIAL proxy, the scraper will return 0 results. Your Apify plan must include Residential Proxy access. Proxy usage is billed separately to your account.

---

Output Example

[
  {
    "item_id": "MLB3787950825",
    "product_id": "MLB38483931",
    "title": "3m fita dupla face 24mm x 2m scotch 5kg extrema fixa forte",
    "price": 34.9,
    "original_price": null,
    "currency": "BRL",
    "discount": null,
    "seller_store": "3m",
    "seller_name": "3M",
    "badge": "RECOMENDADO",
    "coupon": null,
    "is_full": true,
    "shipping": "Chegara gratis amanha por ser sua primeira compra",
    "url": "https://www.mercadolivre.com.br/3m-fita-dupla-face-...",
    "thumbnail": "https://http2.mlstatic.com/D_Q_NP_2X_...",
    "rating": 4.8,
    "sold_quantity": "+10mil",
    "scraped_at": "2026-02-23T02:04:35.849Z"
  },
  {
    "item_id": "MLB3456789012",
    "product_id": "MLB12345678",
    "title": "3m filtro refil purificador de agua acqua pure",
    "price": 89.9,
    "original_price": 109.9,
    "currency": "BRL",
    "discount": "18% OFF",
    "seller_store": "3m",
    "seller_name": "3M",
    "badge": "MAIS VENDIDO",
    "coupon": "Cupom 10% OFF",
    "is_full": true,
    "shipping": "Frete gratis",
    "url": "https://www.mercadolivre.com.br/3m-filtro-refil-...",
    "thumbnail": "https://http2.mlstatic.com/D_Q_NP_2X_...",
    "rating": 4.9,
    "sold_quantity": "+50mil",
    "scraped_at": "2026-02-23T02:04:36.123Z"
  }
]

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 default values using the 3M store example
3. Contact support through Apify for additional assistance