Mercado Libre Deals & Best Sellers Scraper

Mercado Libre Deals & Best Sellers Scraper

Mercado Libre's deals page and its best-seller lists, one row per listing. Pick a country and you get each deal's price, the price it had before, the discount, instalments, shipping, the seller or brand on the card, its rating and Mercado Libre's sold count, with the link and the photo.

It is not a search scraper. There's no keyword box. It reads two pages every Mercado Libre site has: Ofertas, the deals page, and Más vendidos, the best-seller lists. If you need the results of a search such as "iphone 15", this won't give you that.

Nine sites: Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay, Ecuador and Venezuela. Venezuela has no best-sellers page, so it's deals only there. Bolivia, Paraguay, the Dominican Republic and the Central American sites have no deals page at all.

What it reads

Deals (Ofertas). 48 deals a page, in the order Mercado Libre shows them. You can narrow them with the filters the deals page itself has:

• a top-level category, like MLA1051 for Celulares y Teléfonos in Argentina;
• the deal type: lightning deals (Ofertas relámpago) or the deal of the day;
• a price range;
• instalments: payable in instalments, interest-free, best price in instalments, or promoted instalments;
• free shipping;
• Full, Mercado Libre's own shipping service.

The deals page stops at about 1,048 deals for any one set of filters, even when it counts many more. Argentina's counted 11,285 on 13 September 2026. The run's status says when you reach that point, and a category or a price band gets you to the others.

Best sellers (Más vendidos). The lists on that page: up to 20 products for each category Mercado Libre puts there, usually six to ten categories. On 13 September 2026 Argentina's page had 103 products in six lists and Brazil's 154 in ten. The page takes no filters. A category ID keeps only that category's list, if the page has one.

What it doesn't do

• No keyword search. No sorting either: the deals page has none, so rows come in Mercado Libre's order.
• No seller ID, seller reputation, item condition or location. These cards don't show them. seller is the name on the card, which is often a brand or its official store.
• The sold count is Mercado Libre's rounded label, like "+10mil vendidos". soldAtLeast turns it into 10000. It's a floor, not a count.
• Best-seller rows carry less than deals: price, previous price, discount, free shipping, Full and rank. No rating, sold count or seller, because that page doesn't show them.
• Prices are what the page showed when the run read it. Lightning deals often end within hours, and dealEndsAt says when.

Input

{
  "country": "AR",
  "sources": ["deals"],
  "category": "MLA1051",
  "maxPrice": 500000,
  "freeShipping": true,
  "maxItems": 200
}

• Country. Which site to read.
• What to read. deals, bestSellers or both. Empty means deals.
• Category ID. Open the deals page in your browser, pick a category on the left, and the address bar shows category=MLA1051 or similar. It has to belong to the country you picked.
• Deal type, Minimum price, Maximum price, Instalments, Free shipping only, Full only. Deals only. Prices are in the site's own currency.
• Maximum pages. Deals pages, 48 deals each, 22 at most.
• Maximum listings. 1,000 unless you change it, and up to 2,000. Deals and best sellers count together.

If the deals page doesn't recognise a filter value, it quietly shows every deal instead. The actor checks that the page applied each filter you set. If it didn't, you get nothing, you're not charged, and the status names the filter.

Output

One row per listing.

The run also leaves a report, RUN_REPORT, in its key-value store: the filters the page applied, the pages read, how many deals the page counted, rows skipped and why, and why the run stopped.

What you pay

Each listing in your dataset is one charge. Nothing else costs anything: not the sample row you get with an empty input, not a deal that didn't match your filters, not a listing shown twice, and not a page that couldn't be read. If you set a maximum charge for the run, it stops when that's reached. The price is on the Pricing tab.

Limits

• One country per run. Up to 2,000 listings and 22 deals pages.
• It reads about one page every two seconds, so a full deals run takes about a minute.
• When Mercado Libre doesn't serve a page, the status says so and nothing is charged for it.

Where the data comes from

Public pages on Mercado Libre's own sites. Mercado Libre's terms of use restrict automated collection and reuse of its content, so check them against what you plan to do with the data.

Questions

How do I get only phones on sale in Brazil? Country BR, category MLB1051.

Why do I get fewer deals than the page counts? The deals page stops at about 1,048 for one set of filters. Split the run by category or by price band.

Can I get the lightning deals every morning? Schedule the actor with Deal type set to lightning deals. Each run returns the ones on the page at that moment.

Can I search for a product? No. Mercado Libre's search results aren't part of this.