Mercado Livre Product Detail & Reviews avatar

Mercado Livre Product Detail & Reviews

Pricing

from $47.00 / 1,000 product lookups

Go to Apify Store
Mercado Livre Product Detail & Reviews

Mercado Livre Product Detail & Reviews

Extract full product details from any Mercado Livre / Mercado Libre product page — price, discounts, installments, seller reputation, variants, specs, images, stock — plus optional customer reviews. Works in all 18 countries. Feed it URLs or product IDs.

Pricing

from $47.00 / 1,000 product lookups

Rating

0.0

(0)

Developer

Rise and Code

Rise and Code

Maintained by Community

Actor stats

0

Bookmarked

115

Total users

29

Monthly active users

21 days

Issues response

6 days ago

Last modified

Features

Limited permissions

Share

What does Mercado Livre / Mercado Libre Product Detail + Reviews do?

This Actor extracts complete product details from any Mercado Livre / Mercado Libre 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 18 Mercado Libre marketplaces: Brazil, Argentina, Mexico, Chile, Colombia, Peru, Uruguay, Ecuador, the Dominican Republic, Venezuela, Bolivia, Paraguay, Costa Rica, Panama, Guatemala, Honduras, Nicaragua, and El Salvador. Give it product URLs or bare product IDs (MLB…, MLA…, MLM…) and it returns clean, structured JSON. The smaller marketplaces (the Dominican Republic, Bolivia, Paraguay, and the Central American sites) work like classifieds: their pages usually have no ratings, reviews, installments, or original price, so those fields come back empty there.

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 Mercado Livre 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 Mercado Livre?

  • Search by keyword — use our Mercado Livre Search Scraper to find listings for any product, brand, or search term, then feed the resulting urls or itemIds into this Actor for full details and reviews.
  • Daily deals — use our Mercado Livre 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 Mercado Livre 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-128-gb-azul-distribuidor-autorizado/p/MLB1027172667" }],
"maxReviewsPerProduct": 10
}'

Input

Configure the Actor in the Input tab or via JSON.

FieldTypeDefaultDescription
productUrlsarray—Product page URLs — item URLs (/MLB-1234…), catalog URLs (/p/MLB1234…), user-product URLs (/up/MLBU1234…), vehicle and real-estate listings (auto.mercadolibre…, carro.mercadolivre…, departamento.mercadolibre…) and the app's share links (mercadolivre.com/sec/…) all work, from any supported country.
productIdsarray—Product/item IDs, with or without prefix: MLB4233789327, MLB-4233789327, MLBU4270471570, or 4233789327 (resolved with country). Each ID is tried as a listing first, then as a catalog product: for catalog product IDs (productId, variants[].productId), pass the /p/ URL instead (see Limitations).
countrystring"BR"Only used for bare numeric IDs and relative URLs — full URLs and prefixed IDs (MLB…, MLM…) already carry their country. One of the codes in Supported countries.
maxReviewsPerProductinteger0Reviews 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. Each entry is one lookup, even when two entries lead to the same product (an item URL and its catalog page, for example) — you then get one record but pay for both lookups.

Input examples

Full details for one product

{ "productUrls": [{ "url": "https://www.mercadolivre.com.br/apple-iphone-15-128-gb-azul-distribuidor-autorizado/p/MLB1027172667" }] }

A batch of listings by ID

Prefixed IDs carry their own country, so one run can mix marketplaces. For catalog products, pass the /p/ URL instead (see Limitations).

{ "productIds": ["MLB4120125742", "MLM6374966848"] }

Product with its latest customer reviews

{ "productIds": ["MLB4120125742"], "maxReviewsPerProduct": 20 }

Vehicle and real-estate listings

{
"productUrls": [
{ "url": "https://auto.mercadolibre.com.mx/MLM-6374966848-seat-arona-16-style-auto-_JM" },
{ "url": "https://departamento.mercadolibre.com.mx/MLM-2968004285-bucareli-25-_JM" }
]
}

Bare numeric IDs from another country

Numbers without a prefix are read on the site set in country.

{ "productIds": ["6374966848"], "country": "MX" }

Supported countries

Countrycountry codeID prefixRatings & reviews
🇧🇷 BrazilBRMLB✅
🇦🇷 ArgentinaARMLA✅
🇲🇽 MexicoMXMLM✅
🇨🇱 ChileCLMLC✅
🇨🇴 ColombiaCOMCO✅
🇵🇪 PeruPEMPE✅
🇺🇾 UruguayUYMLU✅
🇪🇨 EcuadorECMEC✅
🇻🇪 VenezuelaVEMLV✅
🇩🇴 Dominican RepublicDOMRD— classifieds-style
🇧🇴 BoliviaBOMBO— classifieds-style
🇵🇾 ParaguayPYMPY— classifieds-style
🇨🇷 Costa RicaCRMCR— classifieds-style
🇵🇦 PanamaPAMPA— classifieds-style
🇬🇹 GuatemalaGTMGT— classifieds-style
🇭🇳 HondurasHNMHN— classifieds-style
🇳🇮 NicaraguaNIMNI— classifieds-style
🇸🇻 El SalvadorSVMSV— classifieds-style

Every record's currency is the one its price is shown in on the page.

Output

One dataset record is pushed per product. If a listing you asked for has been ended by its seller, you still get a record for it, with status set to ended (see Output fields). Download the dataset as JSON, CSV, Excel, or HTML from the Output tab or via the Apify API.

Output example (trimmed)

{
"status": "ok",
"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",
"redirectedTo": null,
"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"],
"categoryId": "MLB430121",
"images": ["https://http2.mlstatic.com/D_NQ_NP_2X_….webp"],
"imageCount": 7,
"videoCount": 1,
"hasVideo": true,
"videos": [{ "url": "https://http2.mlstatic.com/storage/shorts-api/…/08VJh9.m3u8", "durationSeconds": 33.23, "thumbnailUrl": "https://http2.mlstatic.com/D_NQ_NP_….jpg" }],
"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 example: a listing its seller has ended

When Mercado Livre shows another listing in place of the one you asked for, the record identifies your input and leaves the product fields empty:

{
"status": "ended",
"productId": null,
"itemId": "MLB1027172667",
"title": null,
"url": "https://produto.mercadolivre.com.br/MLB-1027172667-manopla-freio-de-mo-palio-2009-led-vermelho-_JM",
"redirectedTo": "https://lista.mercadolivre.com.br/acessorios-veiculos/pecas-carros-caminhonetes/pecas-interior/alavanca-freio-mao/",
"siteId": "MLB",
"countryCode": "BR",
"price": null,
"seller": null,
"images": [],
"reviews": [],
"scrapedAt": "2026-11-11T11:57:53.056Z"
}

Output fields

FieldDescription
statusok when the product was scraped. ended when the seller has ended the listing. If Mercado Livre shows a different listing in its place, the record identifies the listing you asked for (itemId, url, siteId, countryCode, scrapedAt) and leaves every product field empty. If it still shows the listing marked as finished, the record keeps what the page shows (title, price, photos, specs); on vehicle and real-estate listings the seller is no longer shown, so it comes back empty. paused when the seller has paused the listing: it is not for sale right now but may come back. Every field is filled as usual, with availability set to OutOfStock.
redirectedToFor ended records, the listing Mercado Livre showed instead — not scraped, since it is not the product you asked for. null otherwise.
productId / itemIdCatalog product ID and marketplace item ID.
title, url, brand, conditionCore identity. condition is new, used, or refurbished.
price, originalPrice, currency, discountPercentageCurrent offer pricing. price is null when the listing is out of stock, since Mercado Livre shows no price on those pages.
installmentsInstallment plan: number of parcelas, value of each, total, interest-free flag.
seller, sellerId, sellerReputation, powerSellerStatusSeller with reputation level (5_green is best) and MercadoLíder tier.
isOfficialStore, isFull, freeShipping, shippingSummaryTrust and logistics flags (FULL = fulfillment by Mercado Livre).
rating, ratingCount, availability, stockLabelAggregate rating and stock status. stockLabel is the site's own text (e.g. "+50 disponíveis"): Mercado Livre caps the number it shows, so read +50 as "more than 50", not an exact stock count.
categoryPath, images, attributes, descriptionCategory breadcrumb, gallery, ficha técnica specs, plain-text description.
categoryId, imageCount, videoCountMercado Livre category ID of the listing (use it with Mercado Livre's public categories API to see which attributes the category requires), and how many photos and videos the gallery has.
hasVideo, videosWhether the gallery has a video, and each video's url (an HLS .m3u8 stream that plays in VLC, ffmpeg or any HLS player), durationSeconds and thumbnailUrl.
variantsEvery SKU option (color, memory, grading…) with its own catalog product ID — to scrape every variant, pass them back as /p/ URLs (e.g. https://www.mercadolivre.com.br/p/MLB2000024221).
subtitleCondition/sales subtitle as displayed (e.g. "Novo | +100 vendidos").
reviewsCustomer reviews (when maxReviewsPerProduct > 0): rating, text, originalText (set when auto-translated from another marketplace), relative date, country, helpful votes, purchased variant.
scrapedAtISO timestamp of extraction.

How much does it cost to scrape Mercado Livre 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:

EventPriceWhen it applies
Per lookup$0.05Once for each URL/ID you submit, as each lookup is processed
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, one per URL/ID submitted. It is charged as each input is processed, not for the whole batch up front: if you stop a run early, the inputs it never got to are not charged, and with a Max total charge set, the run only works on as many inputs as that budget covers. 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 pass them back in productUrls as catalog URLs — https://www.mercadolivre.com.br/p/<productId>, or the same path on that country's site (https://www.mercadolibre.com.mx/p/MLM…). Passed as productIds, a catalog ID can hit an old listing that shares its number.
  • Bulk runs: pass hundreds of IDs at once; each one is processed and charged independently.
  • 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 — see the FAQ below.

Use Mercado Livre Product Detail with AI agents (MCP)

This Actor works as a tool in Claude, ChatGPT, Cursor and other MCP clients through the Apify MCP server. Add it to your client:

{ "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=riseandcode/apify-mercadolivre-product-detail" } } }

The smallest input an agent needs:

{ "productUrls": [{ "url": "https://www.mercadolivre.com.br/apple-iphone-15-128-gb-azul-distribuidor-autorizado/p/MLB1027172667" }] }

Tips for agents:

  • Cost: each URL or ID is a $0.05 lookup; maxReviewsPerProduct adds $0.0015 per review returned, per product. Keep it at 0 unless reviews are needed.
  • Response size: reviews and description are the large fields; leave reviews off for price or stock checks. When reading the results with get-dataset-items, pass fields with only what you need, e.g. title,price,currency,availability,seller,url.
  • Failures: check each record's status (ok, ended, paused) and the run's status message — see What happens when a product fails or isn't found?

Limitations

  • A bare ID is tried as a listing first, then as a catalog product. Catalog and listing numbers overlap, so if an old listing has the same number as the catalog product you meant, you get that listing (often ended) instead. Catalog IDs are the ones in productId, in variants[].productId and in the Search Scraper's productId: pass them as /p/ URLs, not as productIds.
  • A catalog URL (/p/…) shows whichever offer Mercado Livre ranks first right now. Seller, price and itemId can change between runs; to follow one seller's listing, use its item URL or ID instead.
  • Ended listings hide some data. A listing its seller finished comes back as status: "ended"; on vehicles and real estate the advertiser is no longer shown.
  • Review dates are relative ("Há 8 meses") — Mercado Livre doesn't publish absolute dates.
  • Reviews never include who wrote them — no names, avatars or profiles, by design.
  • Classifieds-style markets (Dominican Republic, Bolivia, Paraguay, Central America) have no ratings, reviews or installments.
  • Some real-estate listings show only their first photos on the page: images has those, imageCount the full number.

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 Mercado Livre'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, Mercado Livre, 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 Mercado Livre'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

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.

What happens when a product fails or isn't found?

  • The entry isn't a Mercado Livre URL or ID (a typo, another site): it is skipped before anything is fetched and not charged. If every entry is like that, the run ends FAILED with "Invalid input".
  • The seller ended the listing: you get a record with status: "ended" and pay the $0.05 lookup. A paused listing comes back as status: "paused", out of stock.
  • The URL or ID is valid but leads to no product (removed listing, a search or store page, a page Mercado Livre keeps refusing after automatic retries): no record, the lookup is charged, and the run ends SUCCEEDED with the status message "Done (partial)".
  • No product could be scraped at all: the run ends FAILED with "No products could be scraped".
  • Your maximum cost per run is reached: the run stops cleanly, ends SUCCEEDED with "Done (charge budget reached)", and inputs it never reached are not charged.

The run log names each input that failed and why. Run the failed ones again, or check the URL in a browser. If a valid product keeps failing, please open an issue in the Issues tab.

How do I track Mercado Livre prices over time?

Mercado Livre only shows today's price, so history has to be built by you: schedule the Actor with Apify Schedules on the same list of item URLs or IDs (item URLs follow one seller; catalog URLs follow whoever is winning the offer), keep each run's dataset or send it to a spreadsheet, and compare by itemId.

Does it work with Make, Zapier, Google Sheets or webhooks?

Yes. Every run's dataset can go straight to Google Sheets, Make, Zapier, Slack, Airbyte and more through Apify integrations, or trigger a webhook when the run finishes. To start runs from your own code, use the API call shown in How to use or the Apify client for JavaScript or Python.

Does Mercado Livre have an official API?

It does, but it requires an authenticated app with restricted access. This Actor needs no Mercado Livre account or app — it reads the same public product pages and reviews any visitor sees and returns them as structured data.

Does it work with vehicle and real-estate listings?

Yes, on every marketplace. These are classified ads, so the record looks a little different: seller is the advertiser (a dealer, a real-estate agency or a private person), and attributes holds the vehicle or property details (mileage, year, bedrooms, area…). There are no reviews, ratings or shipping. Some real-estate listings show only their first few photos on the page: images then has those photos and imageCount the full number. Service ads (servicio.mercadolibre…) have no specification table, so their attributes comes back empty.

Do reviews include absolute dates?

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

Disclaimer

This Actor is not affiliated with, endorsed by, or sponsored by Mercado Libre, Inc. or its affiliates. Mercado Livre and Mercado Libre are trademarks of their owner. The Actor collects publicly available data only; you are responsible for using it in line with applicable laws, including data-protection rules.

Changelog

2026-11-07

  • Changed a listing its seller has finished now comes back with status: "ended" even when Mercado Livre still shows its page, instead of ok. The record keeps the details the page still shows.
  • Added status: "paused" for listings the seller has paused, which used to come back as ok and in stock. They now come back out of stock.

2026-11-04

  • Added hasVideo and videos: whether the listing's gallery has a video, and each video's link, duration and thumbnail. Added at a user's request — thanks for the suggestion!

2026-10-22

  • Changed the per-lookup fee is now charged as each input is processed instead of for the whole batch at the start. Stopping a run early no longer charges for inputs it never reached, and a run with Max total charge set only takes on the inputs that budget covers.

Support

Found a bug or have an idea to make this Actor better? Open an issue in the Issues tab. We read and reply to every one, in English 🇺🇸 or Portuguese 🇧🇷.

Enjoying this Actor?

If it saves you time or helps your work, please leave a review. Reviews are the best way to tell us what's worth building next, and they keep us improving it in features, performance and, where we can, cost.