Playground Sign in Start free
E-commerce · mercadolibre.com.mx

How to scrape Mercado Libre

Mercado Libre (mercadolibre.com.mx) is an online store. Our checks of its public pages are failing at the moment. This guide shows what we see, what we tried, and the settings to use once it works again.

Currently blocked

0 of 21 of our checks passed in the last 7 days (0%). Currently blocked: we are working on it, and this page changes as soon as a check passes again.

Last check 2026-10-13 19:35 UTC · last pass never · checked with our own requests, never customer data.

Try it in the Playground

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

What you can get

The API returns the rendered HTML of the page. Select the fields you need with extract rules (CSS selectors) or parse the HTML on your side.

Public pages Currently blocked

Page types we check: Public pages, Detail pages.

The pages carry JSON-LD structured data of type Product.

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one sends the settings on this page, prints the start of the page, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

mercadolibre_page_sdk.py pip install ujeebu-python==0.1.5
# Fetch a Mercado Libre page with the Ujeebu Scrape API.
# Settings from our health checks (Ujeebu site guide). Prints the start of the page HTML.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 mercadolibre_page_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://listado.mercadolibre.com.mx/wireless-earbuds",
]
SETTINGS = {
    "js": True,
    "proxy_type": "premium",
    "proxy_country": "MX",
}


def scrape(client, url):
    try:
        response = client.scrape(url, params=SETTINGS)
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.text


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    html = scrape(client, url)
    print(len(html), "bytes")
    print(html[:500])

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/mercadolibre.json.

Try it yourself

Run this on Mercado Libre with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card. These settings use proxy_country, which is available on paid plans.

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint/scrape
jstrue
proxy_typepremium
proxy_countryMX (paid plans)
Costup to 25 credits a request (only HTTP 200 and 404 are billed)

These settings use proxy_country. Proxy country (geo-targeting) is available on paid plans, so they need a paid plan: the free trial does not include it.

No proxy passed in the last 7 days: these are the settings we keep trying.

Each public page is one request: change the path in the URL to fetch another one. Collect detail page URLs from listing pages first, then fetch each detail page. Our checks run with JavaScript rendering on (js=true): keep it on. Requests are failing on every proxy we tried at the moment; the status above changes as soon as a check passes again.

Try it in the Playground

Troubleshooting

The failures our own checks of mercadolibre.com.mx ran into over the last 7 days, and what got the page in the same check.

What happenedTimesWhat fixed it
The site blocked the request (HTTP 403 or a block page) 19 None of the settings we tried got past it in 7 days.
The page did not load in time 7 Nothing we tried in the same check. Retry later, one request at a time.
A different page than expected 1 None of the settings we tried got past it in 7 days.

A failed request is not billed: only HTTP 200 and 404 responses cost credits.

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • robots.txt of listado.mercadolibre.com.mx (read 2026-10-13): public pages allowed for generic crawlers; no crawl delay set.
  • Read Mercado Libre's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape Mercado Libre with Ujeebu?

Not reliably at the moment: 0 of 21 checks passed in the last 7 days (most failures: the site blocked the request (HTTP 403 or a block page)). We are working on it; this page updates after every check.

Is it allowed to scrape Mercado Libre?

Its robots.txt allows generic crawlers on the page types in this guide. Collect public pages only, read Mercado Libre's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.

How fresh is this page?

The status and settings come from our own health checks of mercadolibre.com.mx, which run around the clock. Last check: 2026-10-13 19:35:24 UTC; no pass recorded yet.