MercadoLivre Product Detail & Reviews

What does MercadoLivre Product Detail + Reviews do?

This Actor extracts complete product details from any MercadoLivre / MercadoLibre product page — price, discount, installments (parcelas), seller reputation, variants (SKUs), technical specs, images, category, stock availability, and optionally the product's customer reviews (avaliações / opiniones).

It works across all 9 MercadoLibre marketplaces: Brazil, Argentina, Mexico, Chile, Colombia, Peru, Uruguay, Ecuador, and the Dominican Republic. Give it product URLs or bare product IDs (MLB…, MLA…, MLM…) and it returns clean, structured JSON.

Running on the Apify platform gives you API access, scheduling, integrations (Google Sheets, webhooks, Zapier, Make), residential proxy rotation, and run monitoring out of the box.

Why use MercadoLivre Product Detail + Reviews?

• Price monitoring & repricing — track precio/preço, discounts, and installment plans for any set of products, on a schedule.
• Competitor & seller intelligence — seller name, reputation level (e.g. 5_green), MercadoLíder/power-seller status, official-store flag, FULL fulfillment flag.
• Catalog enrichment — brand, technical specification attributes (ficha técnica), high-resolution images, category breadcrumbs, and every variant (color, memory, size…) with its own product ID.
• Review mining — pull customer reviews with rating, text, helpful-vote count and purchased variant, ready for sentiment analysis.
• Competitor performance monitoring — point it at a rival's listings and track how their review volume, rating, and sentiment move over time. A sudden drop in rating or a spike in negative reviews after a price change or stock issue is an early signal worth watching.
• Dropshipping & marketplace research — validate products at scale before listing them.

Looking for something else on MercadoLivre?

• Search by keyword — use our MercadoLivre Search Scraper to find listings for any product, brand, or search term, then feed the resulting URLs or IDs into this Actor for full details and reviews.
• Daily deals — use our MercadoLivre Deals Scraper to catch whatever is on promotion on the "Ofertas do Dia" page, with deal type and discount percentage — its results also chain into this Actor.

How to use MercadoLivre Product Detail + Reviews

1. Visit the Actor page and click Try for free (an Apify account takes a minute to create).
2. Paste one or more product URLs — or just the product IDs — into the input form.
3. Optionally set Max Reviews per Product if you also want customer reviews.
4. Click Start and watch the dataset fill up.
5. Download your data as JSON, CSV, Excel, or HTML, or read it via the API.

Or call it straight from the API — this request scrapes one product with 10 reviews and returns the items synchronously:

curl -X POST \
  "https://api.apify.com/v2/acts/riseandcode~apify-mercadolivre-product-detail/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "productUrls": [{ "url": "https://www.mercadolivre.com.br/apple-iphone-15-256-gb-rosa-excelente-recondicionado/p/MLB2000024221" }],
    "maxReviewsPerProduct": 10
  }'

Input

Configure the Actor in the Input tab or via JSON.

Field	Type	Default	Description
productUrls	array	—	Product page URLs — item URLs (/MLB-1234…) and catalog URLs (/p/MLB1234…) both work, from any supported country.
productIds	array	—	Product/item IDs, with or without prefix: MLB4233789327, MLB-4233789327, or 4233789327 (resolved with country). The Actor detects whether each ID is an item or a catalog product automatically.
country	string	"BR"	Marketplace used to resolve bare IDs. One of BR, AR, MX, CL, CO, PE, UY, EC, DO.
maxReviewsPerProduct	integer	0	Reviews to fetch per product, up to 300. 0 means no reviews and no extra cost. See pricing below — you're only charged for reviews actually returned.

You can mix productUrls and productIds in the same run.

Example input:

{
  "productIds": ["MLB4233789327"],
  "country": "BR",
  "maxReviewsPerProduct": 10
}

Output

One dataset record is pushed per product. Download the dataset as JSON, CSV, Excel, or HTML from the Output tab or via the Apify API.

Output example (trimmed)

{
  "productId": "MLB56625214",
  "itemId": "MLB4233789327",
  "title": "Carregador Turbo 40w Compativel Com iPhone 8 X Xr 11 12 13 14 Pro Max Usb Tipo C Duplo",
  "url": "https://www.mercadolivre.com.br/carregador-turbo-40w-.../p/MLB56625214",
  "siteId": "MLB",
  "countryCode": "BR",
  "brand": "Boyu Cell",
  "condition": "new",
  "price": 35.99,
  "originalPrice": 79.11,
  "currency": "BRL",
  "discountPercentage": 54,
  "installments": { "amount": 12, "each": 3.54, "total": 42.48, "isFree": false },
  "seller": "Boyu Cell",
  "sellerId": 334627891,
  "sellerReputation": "5_green",
  "powerSellerStatus": "platinum",
  "isOfficialStore": true,
  "isFull": true,
  "freeShipping": false,
  "shippingSummary": "Chegará grátis amanhã por ser sua primeira compra",
  "rating": 4.8,
  "ratingCount": 9793,
  "availability": "InStock",
  "categoryPath": ["Celulares e Telefones", "Acessórios para Celulares", "Carregadores e Acessórios", "Carregadores"],
  "images": ["https://http2.mlstatic.com/D_NQ_NP_2X_….webp"],
  "attributes": [{ "name": "Marca", "value": "Boyu Cell" }],
  "variants": [{ "attribute": "color", "value": "Rosa", "productId": "MLB2000024221", "selected": true }],
  "description": "Características principais…",
  "reviews": [
    {
      "reviewId": 2444821015,
      "rating": 4,
      "text": "Deixei meu celular carregando…",
      "date": "Há 8 meses",
      "country": "Brasil",
      "likes": 242,
      "variant": "Cor: Rosa"
    }
  ],
  "scrapedAt": "2026-07-02T17:40:18.233Z"
}

Output fields

Field	Description
productId / itemId	Catalog product ID and marketplace item ID.
title, url, brand, condition	Core identity. condition is new, used, or refurbished.
price, originalPrice, currency, discountPercentage	Current offer pricing.
installments	Installment plan: number of parcelas, value of each, total, interest-free flag.
seller, sellerId, sellerReputation, powerSellerStatus	Seller with reputation level (5_green is best) and MercadoLíder tier.
isOfficialStore, isFull, freeShipping, shippingSummary	Trust and logistics flags (FULL = fulfillment by MercadoLivre).
rating, ratingCount, availability, stockLabel	Aggregate rating and stock status.
categoryPath, images, attributes, description	Category breadcrumb, gallery, ficha técnica specs, plain-text description.
variants	Every SKU option (color, memory, grading…) with its own catalog product ID — chain them back into this Actor to scrape all variants.
subtitle	Condition/sales subtitle as displayed (e.g. "Novo | +100 vendidos").
reviews	Customer reviews (when maxReviewsPerProduct > 0): rating, text, originalText (set when auto-translated from another marketplace), relative date, country, helpful votes, purchased variant.
scrapedAt	ISO timestamp of extraction.

How much does it cost to scrape MercadoLivre products?

This Actor uses Apify's pay-per-event pricing: you pay fixed prices for what the Actor does, and you are not charged separately for Apify platform usage (compute, bandwidth, or other infrastructure). There are just two charges:

Event	Price	When it applies
Per lookup	$0.05	Once for each URL/ID you submit, when the lookup starts
Per review	$0.0015 ($1.5 / 1,000)	For each review fetched, only if maxReviewsPerProduct > 0

The per-lookup fee covers the fixed proxy + compute cost of resolving each input and applies as soon as the lookup starts, one per URL/ID submitted. Reviews are billed separately, per product: 3 products with 100 reviews each is 300 charged reviews, not 100, and if a product has fewer reviews available than you asked for, you only pay for what was actually returned.

Examples:

• 100 product URLs, no reviews → 100 × $0.05 = $5.00
• 100 product URLs, maxReviewsPerProduct set to 20 → 100 × $0.05 + 100 × 20 × $0.0015 = $8.00, if every product actually has 20+ reviews available. If a product has fewer, you're only charged for the reviews it actually returned.

Apify's free plan includes $5 of monthly usage — enough for roughly 100 lookups. You can cap any run's spend with the Max total charge run option.

Tips and advanced options

• Scrape all variants of a product: take the variants[].productId values from a first run and feed them back as productIds.
• Bulk runs: pass hundreds of IDs at once — the Actor fetches products over plain HTTP first and only escalates to a real browser for pages protected by anti-bot challenges, keeping runs fast and cheap.
• Budget control: set ACTOR_MAX_TOTAL_CHARGE_USD (Max total charge) on the run; the Actor stops cleanly when the cap is reached instead of failing.
• Scheduling: use Apify Schedules to re-scrape your product list daily and build a price history.

Data & compliance

This Actor is built to collect publicly available data only, with a few deliberate choices to keep its footprint minimal:

• No login, no accounts. The Actor only fetches public product pages and the public reviews endpoint. It never authenticates, so it accesses nothing beyond what any anonymous visitor sees.
• Reviews are anonymized by design. Reviewer names, avatars, and profile links are never extracted — only the rating, text, relative date, country, helpful-vote count, and purchased variant.
• Images are returned as URLs. The Actor never downloads or re-hosts image files; it only points to MercadoLivre's own CDN.
• Seller fields may constitute personal data. seller, sellerId, and reputation fields identify the merchant. When the seller is an individual (not a company or official store), this can qualify as personal data under laws such as Brazil's LGPD — even though it is public. These fields are provided for legitimate business-intelligence purposes (price monitoring, competitor analysis, catalog research). You are the controller of the data you collect: it is your responsibility to have a lawful basis for processing it and to honor data-subject rights in your jurisdiction.
• Descriptions and images are third-party content. Product descriptions, photos, and review texts are authored by sellers, MercadoLivre, or buyers and may be protected by copyright. Use them for analysis; do not republish them as-is (e.g. to clone listings).

Scraping publicly accessible data is generally lawful, but you remain responsible for how you use the output and for complying with MercadoLivre's Terms of Service and the data-protection laws that apply to you (LGPD in Brazil, and their equivalents in the other supported countries). Nothing in this README is legal advice.

FAQ

Is it legal to scrape MercadoLivre?

The Actor extracts publicly available data only, without logging in, and strips reviewer identities. That said, legality depends on how you use the data — see Data & compliance above.

A product failed to scrape — what now?

The run summary lists inputs that could not be resolved. Typical causes: the listing was removed (notfound), or the URL points to a non-product page. If a valid product keeps failing, please open an issue in the Issues tab.

Do reviews include absolute dates?

MercadoLivre only exposes relative dates ("Há 8 meses"); the Actor returns them as-is.

Changelog

2026-07-09

• Changed the per-lookup charge to fire as soon as each URL/ID starts processing, instead of only after a product is successfully parsed — so blocked or failed lookups are billed consistently rather than silently free.
• Validated end-to-end against all 9 supported marketplaces (Brazil, Argentina, Mexico, Chile, Colombia, Peru, Uruguay, Ecuador, Dominican Republic) to confirm country, currency, and site-ID resolution work correctly everywhere.

2026-07-04

• Fixed a review-pagination bug where products with hundreds of reviews sometimes returned just one: MercadoLivre's reviews API returns a single "featured" review on the very first page instead of a full page, and the Actor mistakenly read that as "no more reviews" and stopped.
• Added pay-per-event pricing with reviews billed as their own event, separate from the product price, so you pay for exactly the reviews delivered — nothing extra when a product has fewer reviews than requested.

Support

If you encounter a bug or have a suggestion for this Actor or for a new one, please reach out via the Issues tab or at contact.riseandcode@gmail.com and we'll look into it ASAP. We respond in English 🇺🇸 and Portuguese 🇧🇷. Custom solutions are available on request.