MercadoLivre search $1/1000 results

Pricing

Rating

Developer

Actor stats

Categories

Share

What does this MercadoLivre search scraper do?

This Actor extracts structured product data from MercadoLivre — Brazil's largest e-commerce marketplace — straight from its search results. Pass one or more keywords and get back clean JSON for every product, including title, price, discount, installments, rating, brand, seller, official-store and shipping info, FULL fulfillment, sponsored flag, and category.

Why scrape MercadoLivre search results?

• 📊 Price monitoring — track price changes, discounts, and installment offers for any product category over time.
• 🛒 Competitor research — see which sellers, prices, and products rank for your target keywords.
• 📈 Market analysis — aggregate listing data to find top-rated products, best-sellers, and high-volume sellers.
• 🔎 Lead generation — discover official brand stores and their catalogues at scale.
• 🔥 Trend discovery — spot emerging products and categories by keyword before competitors do.
• 🤖 Automation — schedule runs and push results into spreadsheets, databases, or dashboards through Apify integrations.

Why an Actor instead of doing it yourself?

Unlike a manual search, this Actor turns MercadoLivre's keyword results into structured data at scale. MercadoLivre's official API no longer offers free, open product search (it requires authenticated, restricted access), and the website is built for browsing one page at a time — so collecting listings by hand or with a DIY scraper means fighting pagination, sponsored listings, and bot protection.

How to use this MercadoLivre search scraper

1. Visit the Actor page on Apify and click Try for free — no credit card required.
2. In the Input tab, type one or more search terms (e.g. fitness, pets, mouse gamer).
3. Set Max Items to control how many products to scrape per term — you're charged per product returned.
4. Click Start and wait a few seconds for the run to finish.
5. Open the Output tab or download the dataset as JSON, CSV, Excel, or HTML.

To trigger a run via the Apify API:

curl-X POST \
"https://api.apify.com/v2/acts/rise-and-code~apify-mercadolivre-search/runs?token=<YOUR_TOKEN>"\
-H"Content-Type: application/json"\
-d'{
 "searchTerms": ["fitness", "pets"],
 "maxItems": 100
 }'

Input

Configure the Actor in the Input tab or via JSON.

Example input:

{
"searchTerms":["fitness","pets"],
"maxItems":100
}

Output

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

Output example

[
{
"searchTerm":"carregador celular",
"position":1,
"productId":"MLB178925",
"itemId":"MLB3456789012",
"title":"Carregador Turbo 65W USB-C compatível com Samsung",
"url":"https://www.mercadolivre.com.br/p/MLB178925",
"thumbnail":"https://http2.mlstatic.com/D_NQ_NP_123456-MLB789.jpg",
"seller":"Loja TechBrasil",
"isOfficialStore":true,
"brand":"Samsung",
"price":89.9,
"originalPrice":129.9,
"currency":"BRL",
"discountPercentage":30,
"installments":"ou 12x R$ 7,49 sem juros",
"coupon":"Cupom 5% OFF",
"rating":4.8,
"ratingCount":3627,
"shipping":"Frete grátis",
"isFull":true,
"highlight":"MAIS VENDIDO",
"isSponsored":false,
"isInternational":false,
"category":"MLB-CELL_PHONE_CHARGERS",
"scrapedAt":"2026-04-28T12:00:00.000Z"
}
//...
]

Output fields

How much does it cost to scrape MercadoLivre?

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:

The per-search fee covers the fixed infrastructure every search relies on — premium residential IPs and the compute to reliably load and parse results — and applies on each term search starts.

Examples:

• One search term returning 50 products → $0.04 + 50 × $0.001 = $0.09
• Two search terms returning 50 products each → 2 × $0.04 + 2 × 50 × $0.001 = $0.18

Apify's free plan includes $5 of free usage per month — enough to try the Actor without paying anything.

Tips to keep costs low

• Set maxItems to only what you need — you pay per product returned.
• Each search term started incurs the per-search fee even if it returns few or no products, so prefer specific terms you know have matching listings.

FAQ

Is it legal to scrape MercadoLivre?

This Actor only collects publicly available product listing data — the same information visible to any visitor without logging in. No private user data is collected. Always comply with MercadoLivre's Terms of Service and applicable local laws. Do not use scraped data in ways that compete unfairly with MercadoLivre or its sellers.

Do I need an API key or MercadoLivre account?

No. The Actor works without any MercadoLivre credentials. You only need a free Apify account to run it.

Can I monitor prices on a schedule?

Yes. Use Apify Schedules to run the Actor automatically (e.g. daily) and store each run's dataset, then compare results over time to build price history.

Some fields come back as null — is that expected?

Yes. Not every listing includes all fields. For example, rating only appears when the product has reviews, and originalPrice only when a discount is active. brand and ratingCount are only available for listings tied to a product catalog entry, so individual seller offers and ads often leave them null. Missing fields are set to null rather than omitted so the schema is always consistent.

The scraper got bot-blocked — what can I do?

Blocks are rare: every run uses premium residential IPs and automatic retries to keep success rates high. If a run still comes back empty or partial, simply run it again — transient blocks usually clear on a retry.

Changelog

2026-06-29

• Fixed seller — stripped the leading "Por " prefix from seller names (e.g. "Por Samsung" now returns "Samsung").

2026-06-26

• Added coupon — coupon badge text on the card (e.g. "Cupom 5% OFF").
• Added brand — product brand (e.g. "Samsung").
• Added ratingCount — number of user ratings (e.g. 3627).
• Added isOfficialStore — whether the seller carries the "Loja oficial" (official store) badge.
• Added isFull — whether the listing ships from a MercadoLivre fulfillment center (the FULL badge).
• Removed soldCount — MercadoLivre's current search layout no longer exposes a sold/review count on the card.
• Fixed rating, discountPercentage, shipping, highlight and installments, which had stopped populating after MercadoLivre changed its card markup.

Support

If you encounter a bug or have any suggestion for this Actor or for a new one, please feel free to reach us at contact.riseandcode@gmail.com and we'll look into it ASAP. We respond to emails in English 🇺🇸 and Portuguese 🇧🇷.