Mercado Livre Scraper (Mercado Libre Brazil) | $1.5/1K

Mercado Livre Scraper (Mercado Libre Brazil) | $1.5/1K

US$1.50 per 1,000 listings + US$0.02 per run. Brazilian residential proxies and retries are included; blocked pages and failed queries are never charged.

Search Mercado Livre (MercadoLibre Brazil, mercadolivre.com.br), Brazil's largest marketplace, by keyword and get every listing back as structured data: price, crossed-out price, discount %, installments, seller, official-store flag, rating, units sold, shipping flags and more.

• Up to 20 queries in one run, each one followed through the site's own pagination.
• Up to 1,000 listings per query, in the order Mercado Livre ranks them (position).
• Sponsored ads flagged (isAd: true) or removed with one checkbox, so you can keep organic results only.

Em português: raspe o Mercado Livre do Brasil por palavra-chave e receba preços, descontos, parcelamento, vendedores, notas e avaliações, mais vendidos e frete em tabela pronta pra planilha. Até 20 buscas por execução e até 1.000 anúncios por busca, com proxy residencial brasileiro incluído. Feito pra monitorar preços, acompanhar concorrentes e pesquisar mercado. Custa US$1,50 por 1.000 anúncios mais US$0,02 por execução; página bloqueada não é cobrada.

Need Mexico, Argentina, Colombia or Chile? Use the MercadoLibre Scraper — Search & Prices (MX, AR, CO, CL): the same search data for the Spanish-speaking Mercado Libre sites.

What you get

One row per listing, real output from a "fone bluetooth" search:

{
  "query": "fone bluetooth",
  "position": 1,
  "itemId": "MLB6467824944",
  "productId": "MLB53451486",
  "title": "Fone Ouvido Soundcore Liberty 5 Bluetooth 5.4 ANC 3.0 Redução de Voz 2X Dolby Áudio Hi-Res LDAC Graves Dinâmicos 48h IP55 Carregamento Rápido 6 Mics IA Chamadas Claras App Personalização Cor Auzl",
  "url": "https://www.mercadolivre.com.br/p/MLB53451486",
  "price": 559,
  "originalPrice": 799,
  "discountPct": 30,
  "currency": "BRL",
  "installments": "10x R$ 55,90 sem juros",
  "freeShipping": true,
  "isFull": true,
  "sellerName": "Soundcore",
  "isOfficialStore": true,
  "rating": 4.8,
  "soldText": null,
  "soldQuantity": 500,
  "isAd": true,
  "categoryId": "MLB196208",
  "domainId": "MLB-HEADPHONES",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_841908-MLA99999841907_112025-O.webp",
  "scrapedAt": "2026-09-26T18:42:11.000Z"
}

Field	Meaning
query / position	The search term and where the listing ranked
price / originalPrice / discountPct	Current price, crossed-out price and discount %
installments	Installment plan as shown on the card (e.g. 10x interest-free)
sellerName / isOfficialStore	Seller and whether it's an official store
rating / soldQuantity	Star rating and units sold, when the card displays them
freeShipping / isFull	Free shipping and Fulfillment (FULL) flags
isAd	true for sponsored placements — filter with Include sponsored ads
url / itemId	Canonical listing link and item ID — join with the reviews actor
error	Set only on failed queries — those rows are not charged

Use cases

• Competitor price monitoring: schedule the same queries every day and track price, originalPrice and discountPct per itemId.
• Repricing: see where your listing ranks (position) against the sellers around it, with their price and installment plan.
• Niche and product research: compare soldQuantity, rating and the number of official stores across search terms before you enter a category.
• Official store and seller lists: filter isOfficialStore and sellerName to build a list of who sells what.
• Ads vs organic: keep isAd to measure how much of the first page is paid placement.

How to use it

1. Type search terms into Search queries exactly as a shopper would ("fone bluetooth") — up to 20 per run.
2. Set Max items per query (default 100, up to 1,000) — the actor follows the site's pagination until the limit or the last page.
3. Leave Include sponsored ads on to keep paid placements (marked isAd: true), or turn it off for organic-only results.
4. Run and export — the Price watch dataset view gives you a slim item / price / discount / seller table ready for monitoring.

Input	Type	Default	Notes
queries	array of strings	— (required)	Up to 20 per run; duplicates are removed
maxItemsPerQuery	integer	100	1 to 1,000
includeAds	boolean	true	false = organic results only

Pricing

Pay per event: a small start fee opens the Brazilian residential session, then a flat fee per listing delivered. Blocked pages and failed queries are never charged — and every run respects the maxTotalChargeUsd budget you set on Apify.

Event	Free / Bronze plan	Silver	Gold and above
Listing delivered	US$0.0015	US$0.0013	US$0.0011
Run start	US$0.02	US$0.02	US$0.02

Scenario	Approximate cost
100 listings (1 query)	~US$ 0.17
1,000 listings (1 query, max per query)	~US$ 1.52
10,000 listings (10 queries)	~US$ 15.02

Run cost limit. Every search term costs at least one page load on a residential proxy. If a run keeps costing more than the results it delivers (for example dozens of search terms that return almost nothing, or a long streak of blocked or missing pages), it stops opening new search terms: the ones not opened come back as rows with error: "run-cost-limit" and are not charged. The first search term always runs and normal runs are not affected.

Run it from code

Replace <YOUR_APIFY_TOKEN> with your token from Apify Console → Settings → API & Integrations.

cURL (waits for the run and returns the items):

curl -X POST "https://api.apify.com/v2/acts/gangary~mercado-livre-search-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["fone bluetooth", "air fryer"], "maxItemsPerQuery": 100, "includeAds": false}'

Python (pip install apify-client):

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("gangary~mercado-livre-search-scraper").call(
    run_input={"queries": ["fone bluetooth"], "maxItemsPerQuery": 100, "includeAds": True}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["position"], item.get("price"), item.get("title"))

Node.js (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('gangary~mercado-livre-search-scraper').call({
    queries: ['fone bluetooth'],
    maxItemsPerQuery: 100,
    includeAds: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, items[0]);

The synchronous endpoint waits up to 300 seconds; for big runs (many queries × 1,000 items) start the run asynchronously and read the dataset when it finishes.

Integrations

Everything below is built into Apify, no extra setup on our side:

• Schedules: run the same queries daily or hourly for price tracking.
• Webhooks: get a call to your own endpoint when a run finishes.
• Make, n8n and Zapier: send each run's listings to Google Sheets, a database, Slack or your repricing tool.
• Google Drive: drop each run's export into a shared folder.
• Exports: JSON, CSV, Excel, XML or HTML from the dataset, or straight from the API.

Use with AI agents (MCP)

Apify runs a hosted MCP server, so Claude, Cursor, VS Code and other MCP clients can call this actor as a tool. Add this server URL to your client (it signs in with OAuth on first use, or send Authorization: Bearer <YOUR_APIFY_TOKEN>):

https://mcp.apify.com?tools=gangary/mercado-livre-search-scraper

Then ask in plain words, e.g. "Find the 50 cheapest organic listings for 'air fryer' on Mercado Livre and list the official stores." Setup details for each client: Apify MCP server docs.

FAQ

Is scraping Mercado Livre legal? The actor reads publicly listed search results — no login, no paywall bypass, and no personal data beyond the public store/seller name already shown on every listing card.

Why do some queries come back blocked? Mercado Livre runs aggressive anti-bot protection. When a session gets blocked, the actor drops it, opens a fresh Brazilian residential IP and retries the same page — up to 3 times. If it still fails, the query is abandoned with an error row and you are not charged for it.

Is proxy included? Yes — Brazilian residential proxies are included in the per-listing price. Nothing to configure.

How many results can I get per search term? Up to 1,000 per query per run. Mercado Livre itself stops serving results after ~2,000 per search term (42 pages), so no scraper can go deeper on a single term. For more volume, split the term ("fone bluetooth", "fone bluetooth jbl", "fone bluetooth esportivo").

Is position the same order a shopper sees? Yes. Listings come in the order of the site's own search pages at the moment of the run, sponsored placements included unless you turn them off.

What happens to sponsored ads? With Include sponsored ads on (default), they stay in the results with isAd: true. Turn it off and only organic listings are delivered and charged.

Why are rating, soldQuantity or installments empty on some rows? They are filled only when the listing card shows them. New listings without sales or reviews have no rating or sold count on Mercado Livre either.

Can I get CSV or Excel? Yes. Every run's dataset downloads as JSON, CSV, Excel, XML or HTML, and the Price watch view gives a slim table for spreadsheets.

What does a run with no results cost? Only the US$0.02 start fee. Listings are charged one by one as they are delivered, and error rows are free. You can also cap any run with Max total charge on Apify.

How do I get reviews and the full product page? Take the url values from this actor and paste them into the Mercado Livre Product & Reviews Scraper: specs, description, stock and customer reviews.

Honest limitations

• Mercado Livre itself serves at most ~2,000 results per search term (42 pages) — nothing can scrape deeper than the site offers.
• Per query this actor collects up to 1,000 items per run; for more volume, spread terms across queries (up to 20 per run) or schedule multiple runs.
• Ratings, sold counts and installments appear only when the listing card displays them.
• Sponsored-ad filtering follows the site's own ad marking.

Changelog

• 2026-11-11: run cost limit: a run stops opening new search terms when it keeps costing more than it delivers; those come back as run-cost-limit rows, not charged. A browser session that fails to connect now retries on a new IP instead of returning timeout.
• 0.1.9 (2026-10-30): fixed runs that could end with a single no-data row when the search page took longer to load. The actor now waits longer for the page and switches to a new session when it gets a captcha.
• 2026-10-23: lower per-listing price on higher Apify plans (Silver US$0.0013, Gold and above US$0.0011).
• 2026-09-27: first public release.

From the same maker

• Mercado Livre Product & Reviews Scraper — full product page data plus customer reviews.
• Mercado Livre Best Sellers & Deals Scraper — top 20 per category and the offers of the day.
• Mercado Libre Scraper — Mexico, Argentina, Colombia, Chile — the same search data for the Spanish-speaking Mercado Libre sites.
• Mercado Libre Seller Scraper — every listing of one seller or official store, past the 2,000-result limit.
• Mercado Libre Price Tracker — daily price, stock and Buy Box checks on your own list of listings.

---

If this actor helped you, a rating on its Store page helps others find it. Something broke or a field is missing? Open an issue on the actor's Issues tab.

Keywords: mercado livre scraper, raspar mercado livre, mercado livre price scraper, preços mercado livre, price monitoring brazil, competitor price tracking, e-commerce scraper brazil, mais vendidos mercado livre, avaliações mercado livre, market research brazil.