Mercado Libre's API is closed without a token, and what that leaves you
The official Mercado Libre API requires OAuth and returns 403 to an anonymous request. A comparison of what the API gives an authorised caller, what scraping gives anyone, and which fields exist in only one of the two.
Mercado Libre publishes a documented REST API, and every one of its search and item endpoints answers an anonymous request with HTTP 403 — measured from a direct connection and from proxies in two countries. Getting a token means registering an application and holding an account, which is a different commitment from reading a public page. Scraping returns what the marketplace shows a visitor: listings, prices with a per-row currency, sellers, shipping and, on product pages, ratings and attributes. Neither route returns an exact stock figure, because Mercado Libre's own API answers with a range such as `RANGO_1_50` rather than a number, so an exact quantity is not something either source holds.
Key points
Mercado Libre's search and item endpoints answer an anonymous request with HTTP 403, so the official API is not an option without registering an application and holding an account.
Scraping returns what the marketplace shows a visitor, which is a smaller surface than an authorised API call and is available to anyone without a commercial relationship.
Exact stock is unavailable through either route, because the official API answers with ranges such as `RANGO_1_50` rather than an integer.
The API gives stable identifiers and structured attributes without an anti-bot wall; scraping gives coverage across all 17 marketplaces without a per-country application approval.
Per-row currency is a scraping-side concern that the API sidesteps, because an API response names its currency per item rather than leaving it in a rendered price string.
Mercado Libre publishes a documented REST API. Whether it is available to you is a different question from whether it exists.
The API is closed to anonymous callers
Every search and item endpoint answers an unauthenticated request with HTTP 403. Not a rate limit, not a throttle — a refusal. Getting past it means registering an application and holding a Mercado Libre account, which is a commercial relationship rather than a technical step.
What a token actually buys you
Stable identifiers, structured attributes, and no anti-bot wall. An API response names its own currency per item rather than leaving it inside a rendered price string, which sidesteps the problem that six marketplaces create for a scraper. It also gives you the authenticated surface — your own listings, your own orders — that no amount of scraping should ever reach.
What scraping gives anyone
What the marketplace shows a visitor, across all seventeen countries, with no application approval per market and no account to maintain. Listings, prices with a per-row currency, sellers, condition and shipping; and on product pages, ratings, attributes and the Venezuelan dual price. The cost is the wall, and the wall is real.
What neither route returns
An exact stock or sales figure. Mercado Libre does not publish one: the page shows +25 vendidos and the official API answers RANGO_1_50 for the same field, so the number is absent from the source rather than hidden by it. Any dataset carrying an exact integer there produced it by choosing a point inside a range.
Choosing between them
If you need the authenticated surface, there is no choice to make — the API is the only route and the relationship is the price. If you need the public catalogue across several countries, scraping is available today without an approval process per market, and the limits are the wall, the roughly 2,000 items per query, and a robots.txt with no polite pagination in it.
Frequently asked questions
▸Can I call the Mercado Libre API without a token?
No. The search and item endpoints answer an anonymous request with HTTP 403, so reading anything through the official API means registering an application and holding a Mercado Libre account first.
▸Is scraping a replacement for the API?
It is a replacement for the read-only, public-catalogue part of it. Anything that needs an authenticated relationship — managing your own listings, orders, or private seller data — is not available by scraping and should not be.
▸Which route gives exact stock numbers?
Neither, because Mercado Libre does not publish them. The site shows `+25 vendidos` and the official API answers `RANGO_1_50` for the same field, so any tool returning an exact integer has invented it from a range.
Sources
Every URL below was requested and returned a page on the date shown.
A working method for extracting listings and product pages from any of the 17 Mercado Libre marketplaces, including the two decisions — pagination and detail pages — that decide what a run costs.
Mercado Libre results mix `articulo.…/MLA-…`, `/p/MLA…` and `/up/MLAU…` links. Deriving the item id from the URL looks fine until the third shape appears, which can be nearly half a page.
Which fields only exist on product pages, what turning on `scrapeDetail` does to a run's page loads and its bill, and how to get the enriched fields for only the rows that need them.
