Mercado Livre Product Scraper

Automate product research on Mercado Livre — Brazil's largest e-commerce marketplace. Scrape product names, prices, discounts, seller info, ratings, free shipping status, and more from search results in structured, analysis-ready JSON.

---

What It Does

The Apify Mercado Livre Scraper lets you extract product listings from Mercado Livre search results at scale. Instead of manually browsing thousands of products, you provide a list of keywords and let the Actor run through every search result page, pulling structured data for each item — including price, brand, seller, installment options, free shipping flags, MeliChoice status, best seller badges, and more.

The Actor is designed to handle Mercado Livre's anti-bot protections, automatically rotating residential proxies and re-trying on blocked requests so you can focus on the data instead of infrastructure.

---

Use Cases

• Price monitoring & competitor analysis — Track how products in a specific category are priced across sellers and spot opportunities or price drops over time.
• Market research for importers and retailers — Feed a list of keywords (e.g., product names or categories) and receive a clean dataset with prices, brands, and seller names to feed into pricing engines or dashboards.
• Product catalog building — Scrape an entire category of products (e.g., "smartphones" or "game console cards") and export the results to a spreadsheet or database for inventory planning.
• Brand presence tracking — Find every listing for a given brand or product ID on the platform and see where it ranks, how many units have been sold, and whether it carries a MeliChoice or official store badge.
• E-commerce data pipelines — Connect the Actor's JSON output to tools like Google Sheets, Airbyte, Fivetran, or custom ETL pipelines for ongoing market intelligence.

---

Input

Parameter	Description
Keywords	A list of search terms to look up on Mercado Livre. You can provide product names, categories, or specific queries (e.g. ["smartphones", "notebooks"]).
Max Pages	The maximum number of result pages to scrape per keyword (default: 1). Each page contains 48 products.

Example input:

{
  "keywords": ["smartphones", "notebooks"],
  "maxPages": 2
}

---

Output

Each run produces a dataset where every row is a single product listing. Fields include:

• Product info: name, brand, category ID, item URL, image URL
• Pricing: price (BRL), original/base price, discount percentage, installment info
• Seller info: seller name, whether it's an official store, international shipping
• Shipping & logistics: free shipping flag, logistic type (e.g. fulfillment)
• Quality & availability: rating value & count, sold quantity, MeliChoice badge, best seller, lightning deal, last units, unmissable offer
• Search metadata: the keyword used to find the product, its position on the page, result type

Sample record:

{
  "itemId": "MLB4625689287",
  "seller": "Azbuy",
  "installment": "4x 29.98 sem juros BRL",
  "isInternational": false,
  "categoryId": "MLB5095",
  "domainId": "MLB-CELLPHONE_CASES_AND_COVERS",
  "isOfficialStore": true,
  "productName": "Capa Anti Impacto Transparente Ringke Original Fusion Para Samsung Galaxy S26 Ultra Reforçada Trasparente Lisa",
  "image": "https://http2.mlstatic.com/D_NQ_NP_740217-MLA109560296839_032026-F.jpg",
  "ratingCount": 1345,
  "ratingValue": 4.8,
  "url": "https://www.mercadolivre.com.br/capa-anti-impacto-transparente-ringke-original-fusion-para-samsung-galaxy-s26-ultra-reforcada/p/MLB67276752",
  "brandName": "Ringke",
  "hasFreeShipping": true,
  "position": 13,
  "restultType": "ORGANIC",
  "productId": "MLB67276752",
  "discountPct": 14,
  "priceCurrency": "BRL",
  "price": 119.9,
  "priceBase": 139.9,
  "soldQuantity": 500,
  "shippingLogisticType": "fulfillment",
  "isBestSeller": false,
  "isLightningDeal": false,
  "isLastUnits": false,
  "isMeliChoice": false,
  "isUnmissableOffer": false,
  "keyword": "capa-de-celular"
}

---

Notes

• Region: The Actor is configured for Mercado Livre Brazil (mercadolivre.com.br) by default. Adjust the proxy country code if you need listings from other Mercado Livre marketplaces.
• Login not required: The Actor does not need Mercado Livre account credentials — all product data is publicly available.
• Pagination: Set maxPages to scrape more results for a keyword.