Mercado Livre Scraper: Brazil prices, units sold, Full and sellers

Scrape Mercado Livre, Latin America's largest marketplace, in Brazil, without an account. Type a search term with price, condition and sort filters, paste any search or category URL, or paste product links. Every product comes with the price, the price before discount and discount, the Pix price note, installments, units sold, rating, free shipping, Mercado Livre Full, official store, the sponsored flag and its position in the results.

Turn on the full product page and you also get the seller (name, ID, reputation, number of sales and highlights), stock, review count, installment plan, category path, the description and the full specifications table.

Built for price monitoring and ranking tracking: schedule the same search every day and get only the products that are new, or whose price changed, with the previous price and the change in reais and percent.

Mercado Livre scraper at a glance

• Price per 1,000 products, Free plan: US$ 4.00
• Full product page (optional): US$ 8.00 per 1,000, on top
• Fee per run start: US$ 0.03, only when the run gets through Mercado Livre's security check
• Search terms, search and category URLs, product links: Yes
• Units sold, Full, free shipping, sponsored flag, position: Yes, on every row
• Price, condition and sort filters: Yes, with Mercado Livre's own filters
• Seller name, ID, reputation and sales: Yes, with the full product page
• Only new products since the last run (onlyNew): Yes, free when nothing is new
• Price tracking between runs (trackPriceChanges, onlyPriceDrops): Yes
• Error rows (bad URL, no results, site refusal): Free, with an errorCode

Mercado Livre data: real rows

From tests on 2026-10-08. A search row ("iphone", page 2):

{
  "type": "product",
  "itemId": "MLB4763403461",
  "catalogProductId": "MLB2000017029",
  "title": "Apple iPhone 14 (256 Gb) - Meia Noite - Bom (Recondicionado)",
  "url": "https://www.mercadolivre.com.br/apple-iphone-14-256-gb-meia-noite-bom-recondicionado/p/MLB2000017029",
  "price": 2460,
  "originalPrice": 2590,
  "discountPct": 5,
  "currency": "BRL",
  "priceNote": "no Pix",
  "priceOtherPaymentMethods": 2590,
  "installmentsText": "ou R$ 2.590,00 em outros meios",
  "condition": "Recondicionado",
  "soldQuantity": 100,
  "rating": 4.8,
  "freeShipping": true,
  "shippingText": "Frete grátis",
  "fulfillment": false,
  "officialStore": null,
  "isSponsored": false,
  "categoryId": "MLB1055",
  "domainId": "MLB-CELLPHONES",
  "image": "https://http2.mlstatic.com/D_NQ_NP_793103-MLA95689874536_102025-O.webp",
  "position": 50,
  "page": 2,
  "searchInput": "iphone"
}

And the extra fields of a full product page (a product link), shortened:

{
  "hasDetails": true,
  "detailCondition": "Novo",
  "detailPrice": 70.9,
  "installments": 12,
  "installmentAmount": 6.98,
  "installmentsTotal": 83.76,
  "sellerId": 1436636826,
  "sellerName": "NEXTBYTESTORE",
  "sellerReputation": "4_light_green",
  "sellerType": "eshop",
  "sellerUrl": "https://www.mercadolivre.com.br/pagina/nextbytestore",
  "sellerSales": "+50",
  "sellerHighlights": ["Bom atendimento", "Entrega no prazo"],
  "sellerIsBusiness": true,
  "isOfficialStore": false,
  "sellerPowerStatus": "platinum",
  "sellerMedal": "MercadoLíder Platinum",
  "sellerReputationRank": 5,
  "sellerSalesCount": 10000,
  "listingType": "classic",
  "listingTypeId": "gold_special",
  "maxInstallments": 12,
  "installmentsInterestFree": false,
  "isFull": true,
  "logisticType": "fulfillment",
  "sellerPaysShipping": false,
  "detailSoldQuantity": 1000,
  "stockText": "+50 disponíveis",
  "availableQuantity": 51,
  "description": "A Máquina de Acabamento Profissional T&Z TZ-154 combina design e tecnologia para cortes precisos...",
  "specifications": {"Cor": "Preto", "Marca": "TZ", "Modelo": "TZ-154"},
  "sku": "MLB7662788792",
  "shipsFrom": "São Paulo",
  "inStock": true,
  "brand": "TZ"
}

Seller reputation (sellerMedal, sellerReputationRank from 1 to 5, sellerSalesCount), listing type (classic or premium), interest-free installments and Full come from the product page. For sellers that are not a store (private individuals), only these aggregate numbers are returned: no seller name or profile link.

Catalog products (links with /p/MLB...) also bring reviewCount, soldText ("+100"), model and categoryPath, and itemId is the listing that currently wins the buy box.

How to use the Mercado Livre scraper

By search term, with Mercado Livre's own filters:

{
  "searchTerms": ["air fryer", "tenis nike"],
  "sortBy": "priceLowToHigh",
  "minPrice": 200,
  "maxPrice": 600,
  "condition": "new",
  "maxItems": 100
}

By URL. Open Mercado Livre, set any filter (brand, store, Full, shipping, condition...) and paste the address. Every filter in the URL is kept, and the Actor follows the site's own next-page links (a top-level category link that opens Mercado Livre's category showcase is read as the full product list of that category):

{
  "startUrls": ["https://lista.mercadolivre.com.br/iphone_PriceRange_2000-4000_NoIndex_True"],
  "maxItems": 200
}

By product link. Paste product URLs (/p/MLB... or produto.mercadolivre.com.br/MLB-...). Each comes back with the full product page.

skipSponsored leaves out paid ads, and onlyFulfillment keeps only products shipped by Mercado Livre Full. Skipped rows are not charged.

Mercado Livre price monitoring

Schedule the Actor with the same input every day and turn on:

• onlyNew: only products this search never returned before. The first run delivers up to maxItems and remembers everything it read; later runs deliver only what is new. Products already seen are not charged.
• trackPriceChanges: every row gets previousPrice, priceChange, priceChangePct, isPriceDrop, isNewProduct, firstSeenAt and previousSeenAt. With onlyNew on too, products whose price changed are delivered as well.
• onlyPriceDrops: with both of the above, of the products seen before, only the ones that got cheaper.
• Units sold in the period: with trackPriceChanges (or onlyNew), rows also get previousSoldQuantity, soldSinceLastRun and soldPerDaySinceLastRun. Mercado Livre rounds units sold ("+100", "+5mil"), so the change shows up when a product moves to the next bracket.

The memory lives in a key-value store in your own account (mercadolivre-scraper-state), one entry per search. Delete it to start over.

Video guides from Apify: how to schedule an Actor and how to connect it to other apps.

Who uses Mercado Livre data

• Sellers on Mercado Livre tracking competitors' prices, units sold and ranking for their key searches.
• Brands and distributors checking how resellers price their products and who sells through Full.
• Market researchers sizing categories by units sold, average price and share of official stores in Brazil.
• Price comparison and deal sites that need fresh Brazilian prices with the Pix and installment conditions.

Mercado Livre scraper limits and good to know

• Mercado Livre shows 48 products per page and at most 2,000 per search. Split larger searches by price range or category.
• soldQuantity is the rounded figure Mercado Livre publishes ("+100" becomes 100), not an exact count.
• The seller's name is on search rows only for official stores; turn on the full product page to get every seller.
• Prices are in Brazilian reais (BRL). Product names, categories and specifications come in Portuguese.
• Mercado Livre asks for a security check. The Actor passes it once per run in a real browser on a Brazilian residential IP (two browsers race, the first one through wins), then reads pages with plain HTTP. Some IPs are refused and the Actor moves to the next one, so the first products usually arrive in one to two minutes. The check is saved in the mercadolivre-scraper-state key-value store, so the next run in your account often skips the browser. If every attempt is refused, you get a free BLOCKED row and the run start is not charged. Keep the default proxy (RESIDENTIAL, country BR).

Mercado Livre scraper pricing

Pay per product: US$ 4.00 per 1,000 products on the Free plan (lower on paid Apify plans), plus US$ 8.00 per 1,000 for products delivered with the full product page, and US$ 0.03 per run that gets through the security check. Error rows, duplicates and products skipped by filters or onlyNew are never charged.

Mercado Livre scraper error codes

errorCode	Meaning
INVALID_INPUT	The URL is not a Mercado Livre search, category or product link, or a filter is wrong
NO_RESULTS	Mercado Livre found no product for this search and filters
NOT_FOUND	The product does not exist (paused, removed or a wrong link)
BLOCKED	The security check refused every attempt on fresh IPs; run again in a few minutes
NOT_REACHED	The run timeout came before this input
UNEXPECTED	Anything else; run again, and open an issue if it repeats

Mercado Livre scraper FAQ

Do I need a Mercado Livre account? No. The Actor reads public pages only.

Why not the official Mercado Livre API? Mercado Livre's developer API needs a registered app and an access token, and is built mainly for sellers managing their own listings and orders. This Actor needs no app or token and returns what the site shows to buyers, including the Pix price, units sold, Full, the sponsored flag and the position in the results.

Other countries (Argentina, Mexico...)? Not in this version: Mercado Livre Brazil only.

Can I get reviews and questions? Not in this version. Rating and review count are included.

Related scrapers

• Magalu Scraper: Magazine Luiza prices, Pix prices and sellers.
• Kabum Scraper: Brazil hardware prices and stock.
• Shopee Scraper: Shopee products, prices and shops in 8 countries.
• AliExpress Scraper: AliExpress products, sold counts and 40 fields.
• Google Shopping Scraper: product prices, offers and EAN lookup from Google Shopping.