Cookbook·Marketplaces·mercadolivre.com.br
Scrape product pages on mercadolivre.com.br
The call that returns product pages from mercadolivre.com.br today, with the parameters, patterns and failure modes read off the request log since 14 Aug 2026.
99.8% success · Aug 2026Browser on 43% of callsModerate price · 1.5 credits
Measured on Crawlbase
Success rate over every request from every account in August 2026: 99.8%. Patterns, countries and failures come from the request log since 14 Aug 2026; 43.1% of successful calls used the JavaScript token and the median answer took 2.9s.
Among the 16 marketplaces sites in the Cookbook, mercadolivre.com.br sits at 5 of 16 by success rate; the category median is 99.6%. Its median answer of 2.9s is faster than the category median of 7.1s. 7 of the 16 accept the plain token; this one does on some pages only.
The call
Product pages are the shape the accounts fetch most here, with the country and token that succeed most often. Replace the placeholder path with a real product URL from the site.
curl "https://api.crawlbase.com/?token=YOUR_TOKEN&country=BR&url=https%3A%2F%2Fwww.mercadolivre.com.br%2Fexample-page"from crawlbase import CrawlingAPI api = CrawlingAPI({'token': 'YOUR_TOKEN'}) r = api.get('https://www.mercadolivre.com.br/example-page', {'country': 'BR'}) html = r['body']
const { CrawlingAPI } = require('crawlbase'); const api = new CrawlingAPI({ token: 'YOUR_TOKEN' }); const r = await api.get('https://www.mercadolivre.com.br/example-page', { country: 'BR' });
Parameters that matter
| Parameter | Set it to | Why |
|---|---|---|
country | BR | 51.3% of successful calls set it and they succeed at 100%; calls without a country succeed at 99.5%. |
javascript | leave unset | Plain-token calls succeed at 99.5%, JavaScript-token calls at 99.7%. Both work; start without the browser and switch per URL pattern where the table below shows it. |
URL patterns accounts fetch
| Pattern | Share of successes | JavaScript token | Country | Query parameters |
|---|---|---|---|---|
/{slug} | 91.8% | 0.5% | BR | none |
Fields you get
A product page usually carries an ld+json Product block with name, price, currency and availability, and the same values in the visible markup. Read the block first; it changes less often than the layout.
What breaks, and the fix
Of the failures since 14 Aug 2026, the site answered:
403: 56.3% of failures A 403 is the site refusing the exit. Set the country the successful calls use and retry once; a second 403 means the URL itself is protected.
999: 18.8% of failures 999 is not a standard HTTP answer; the site sent it as a refusal. Treat it like a block: retry once with the JavaScript token and the country the successful calls use, then stop.
504: 6.3% of failures A 504 is a timeout: the page did not finish inside the limit. Retry once, and keep your own client timeout above the median answer time shown for this site.
515, 503: 18.8% of failures together A 5xx is the site failing, not the fetch. Retry after a minute.
Run it on a schedule
A catalogue refresh is a list of product URLs. Push it to the Crawler with a callback, let it pace the calls and retry what the site refuses, and read the results from Cloud Storage. The median answer on this site is 2.9s.
Questions
Do I need a browser to scrape mercadolivre.com.br?
It depends on the page. Plain-token calls succeed at 99.5%, JavaScript-token calls at 99.7%; the URL pattern table shows which paths accounts fetch with a browser.
How much does a mercadolivre.com.br page cost on Crawlbase?
1.5 credits without a browser. mercadolivre.com.br is in the moderate tier.
Which country should I set for mercadolivre.com.br?
BR: that is what 51.3% of successful calls use.
Site names identify the pages a recipe fetches. Crawlbase is not affiliated with any site listed. Use recipes within the acceptable use policy.Measured numbers from August 2026, refreshed monthly