Mercado Livre Brazil Scraper: Deals, Prices, Sellers and Product Videos

Mercado Livre Brazil Scraper turns Mercado Livre Brazil (mercadolivre.com.br), Latin America's largest online marketplace, into structured product data. The default category mode walks the marketplace's best-sellers and category feeds with auto-paging, no login needed. Every product comes back with its price, old price, discount percentage, sold counts, shipping signals, images and sellers. A video mode returns the marketplace's product-clip feed with playable video URLs, view counts, prices and discounts. Export to JSON, CSV or Excel, pull the results through the API, or schedule the actor to track only what changed.

Why This Scraper?

• Auto-paging category feeds. Walk every tab the app's home page shows (Tudo, Moda, Beleza, Celulares, Veículos, Supermercado, Lar, Computação, Televisores, Tv, Primeira Compra) with continuous auto-paging. The feed keeps serving fresh products page after page, just set max products.
• Sold counts and shipping signals. Every card carries its marketplace sold count, free-shipping flag, FULL badge and coupon percentage where present.
• Incremental mode. Schedule the actor and only pay for new and changed products; unchanged rows are suppressed automatically.
• Product videos included. A dedicated video mode returns the marketplace's product-clip feed: playable video URLs, view counts, prices, discounts and seller names for every clip.
• Clean, honest output. Every product carries its marketplace id, canonical URL, prices, discount percentage, sold counts, shipping signals and the seller's details. The dataset schema declares every field the Output tab renders.

Use Cases

• Price monitoring: track best-sellers and category feeds on a schedule to spot price drops and discount trends.
• Market research: walk category feeds across the app's tabs to see what's actually selling.
• Competitive analysis: extract sold counts, discounts and shipping signals to benchmark sellers and products.

Data You Get

Sample shape: values are illustrative placeholders, not from a live record.

Field	Example	Source
itemId / productId	"MLB50196682" / "MLB12345678"	every product
title	"Sony PlayStation Store Gift Card R$ 150"	category mode
price / originalPrice / discountPct	150.0 / 199.0 / 25	when the card carries them
currency	"BRL"	every product
soldText	"+5mil", "+1000"	best-sellers cards
installmentsText	"5x R$ 30 sem juros"	when the card carries them
freeShipping / full	true	when present
couponPct	15	coupon-eligible products
shippedFrom	"Internacional"	cross-border products
sellerId / officialStoreId / logisticType	3339513751 / 307542 / "fulfillment"	merged from the home feed
categoryId / categoryIdPath / domainId / vertical	"MLB271772" / ["MLB117798"] / "MLB-AIR_CONDITIONERS" / "CORE"	merged from the home feed
imageUrl / videoUrl	https://http2.mlstatic.com/...webp	every product
bestSeller / lightningOffer	true	badges on the card
catalogListing / catalogProductId	true / "MLB12345678"	catalog products
sellerName	"COMERCIAL ELETRO"	video mode
viewsText / durationSec	"9.406.217 de visualizações" / 55	video mode
couponPct / shippedFrom	15 / "Internacional"	when present
viewsText / durationSec	"9.406.217 de visualizações" / 55	video mode

How to Use

1. Pick a mode: category (default, walks the category feeds with auto-paging) or videos (the marketplace's product-clip feed).
2. For category mode, optionally select categories to walk (multi-select: Moda, Beleza, Celulares, Veículos, Supermercado, Primeira Compra, Lar, Computação, Televisores, Tv). Empty walks the general Tudo feed.
3. Set Max products to cap the run. Auto-paging continues until the cap or the feed runs out of fresh products.

Run it from your code

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("n95g7MqAgRI3UrYX0").call(run_input={
    "mode": "category",
    "category": ["moda", "celulares"],
    "maxItems": 100,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('n95g7MqAgRI3UrYX0').call({
    mode: 'category',
    category: ['moda', 'celulares'],
    maxItems: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Connection and cost shape

The category and video feeds are served by the marketplace's own mobile API and answer every anonymous visitor, no login, no browser and no rendering engine are needed. Runs use the Residential proxy tier with country Brazil by default. Compute is billed by RAM-seconds: a full 144-product pull costs a fraction of a cent.

Output views

The dataset has two views: Products (overview) and Changes (incremental status and changedFields).

Resume and recurring updates

Incremental mode (incrementalMode) is for recurring monitoring of the same category feed. The first run returns everything as NEW. Later runs return NEW and UPDATED products (with changedFields naming what moved), and suppress UNCHANGED ones unless Emit unchanged is on. Emit expired additionally tombstones products that a run no longer finds as EXPIRED, but only once a run has completely scanned the tracked feed: never when Max products capped it, never after a resume, and never when a run collected nothing. State key names a campaign or deliberately shares one. What is compared: every returned field except scrapedAt (changes on every scrape), reviews (the review rows; a new review still moves reviewCount and rating, which are compared), searchPosition (rank on the page), totalResults (size of the result set), searchKeyword (the query that found the product), resultType and sponsored (how this run found the row) and highlight (the ranking badge such as MAIS VENDIDO), which depend on the page rather than on the product. Ignore fields when detecting changes (ignoreFieldsForChanges) adds your own exclusions.

Send results into your apps (MCP connectors)

Connect the actor's dataset to Notion and other MCP-compatible endpoints using the MCP connectors input. See the MCP connectors documentation for details.

Input Parameters

Parameter	Type	Default	Description
mode	select	category	category: walk the category feeds. videos: the product-clip feed.
category	array (multi-select)	[]	Which category tabs to walk, in order. Empty walks the general Tudo feed.
maxItems	integer	20	Hard cap on products returned and billed.
maxPages	integer	0	Optional bound on pages walked per category. 0 = unlimited.
proxy	object	Residential BR	Apify Proxy configuration.
incrementalMode	boolean	false	Only return new/changed products on scheduled re-runs.
emitUnchanged	boolean	false	Include unchanged products in incremental runs.
emitExpired	boolean	false	Tombstone products no longer found.
stateKey	string	(empty)	Name a campaign to share or isolate its baseline.
ignoreFieldsForChanges	array	[]	Fields to exclude from change detection.
mcpConnectors	array	[]	MCP connector targets.
notionParentPageUrl	string	—	Notion parent page for MCP export.
maxNotifyListings	integer	50	Max listings per notification.

Output Example

Sample shape: values are illustrative placeholders, not from a live record.

{
  "itemId": "MLB50196682",
  "title": "Sony PlayStation Store Gift Card R$ 150 (Digital)",
  "price": 150,
  "currency": "BRL",
  "soldText": "+50mil",
  "installmentsText": "5x R$ 30 sem juros",
  "imageUrl": "https://http2.mlstatic.com/D_Q_NP_2X_902418-...webp",
  "url": "https://www.mercadolivre.com.br/MLB50196682"
}

Plan Requirement

You pay per product returned, plus one Actor start charge per run. The Pricing tab shows the current rates. Use Max products to cap the cost of any run.

FAQ

How much does it cost?

You pay per product returned, plus one Actor start charge per run. The Pricing tab shows the current rates. Use Max products to cap the cost of any run.

Is it legal to scrape Mercado Livre?

Scraping publicly available data is generally legal as long as you do not breach any agreements or access data behind authentication. This actor only reads publicly visible product feeds.

Can I get only new or changed products on a schedule?

Yes, turn on Incremental mode and schedule the actor. The first run returns everything; later runs only return new and changed products. See Resume and recurring updates above.

Can I use it with AI agents or MCP?

Yes, connect the dataset to any MCP-compatible client using the MCP connectors input, or pull the results through the API.

A category link that carries a keyword

If you paste a category path with a keyword, the marketplace may serve it as the plain keyword search and drop the category, so the results can differ from what the category alone would show.

🔗 More scrapers you might like

Pair this actor with these related scrapers from the same team:

🛒 Americanas Brazil Scrape Americanas Brazil (americanas.com.br) by keyword, department or pasted link...	🔌 Casas Bahia Brazil Electronics & Home Goods Scraper Scrape products from Casas Bahia Brazil by keyword, department, or URL. Filter by brand...
🛒 Netshoes Brazil Scrape sportswear and footwear from netshoes.com.br. Search by keyword with the store's...	🛒 Drogasil Brazil Pharmacy, Health & Beauty Scraper Scrape Drogasil (drogasil.com.br) medicines, health and beauty products by keyword...
🏠 QuintoAndar Scraper Scrape QuintoAndar property listings across Brazil with 80+ fields, including rent, sale...	🏠 Zap Imóveis Scraper Scrape Zap Imóveis sale, rental and new-development listings by city, filters or URL...

👉 Browse all abotapi scrapers

💬 Support

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email contact@abotapi.com.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.