MercadoLibre Best Sellers Scraper

Scrapes public best-seller ("mas vendidos") listings from MercadoLibre Mexico. No login, no session cookies, no CAPTCHA solving, no proxy services: plain HTTPS with a normal browser User-Agent and roughly one request per second between pages.

What it scrapes and who would use it

The actor collects the ranked best-seller products shown on the public mas-vendidos listing surfaces: rank within the category carousel, category, title, current price in MXN, product URL, and image URL. Useful for competitive research, price benchmarking, demand spotting, and catalog gap analysis on the MercadoLibre Mexico marketplace.

Inputs

Field	Type	Default	Description
categories	array of strings	[] (built-in starter list)	Best-seller category pages to scrape. Each entry may be a full URL (e.g. https://www.mercadolibre.com.mx/mas-vendidos/MLM1051) or a MercadoLibre category code (e.g. MLM1051). The built-in starter list covers six Mexican categories discovered on the mas-vendidos hub: Celulares y Telefonia, Ropa Bolsas y Calzado, Salud y Equipamiento Medico, Computacion, Accesorios para Vehiculos, Consolas y Videojuegos.
max_items	integer	500	Maximum product records to push across all categories; the run stops when reached.
country	string	"mx"	MercadoLibre country site. Tested: mx. Other sites (ar, br, cl, co, pe, ve, uy) are accepted on a best-effort basis and only their mas-vendidos listing surfaces are used.

Sample output record

{
  "rank": 1,
  "category": "Celulares y Telefonía",
  "title": "Audífonos In-ear Bluetooth Para Celulares, Tablets y Laptops, Conexión Automática, Resistente al Agua y Polvo IP55, Cómodo de Llevar, Estuche de Carga Gran Capacidad, Marca MVPSMART R30 Blanco",
  "price_mxn": 124.64,
  "sold_quantity": null,
  "product_url": "https://www.mercadolibre.com.mx/audifonos-in-ear-bluetooth-para-celulares-tablets-y-laptops-conexion-automatica-resistente-al-agua-y-polvo-ip55-comodo-de-llevar-estuche-de-carga-gran-capacidad-marca-mvpsmart-r30-blanco/p/MLM44007277",
  "image_url": "https://http2.mlstatic.com/D_Q_NP_2X_851731-MLA100096823243_122025-AB.webp"
}

Coverage and limits

• The mas-vendidos hub page (/mas-vendidos) is the reliable source: it exposes six category carousels with roughly 20 ranked items each (about 115-120 records total per run).
• Category subpages deliberately attempted, then skipped: per-category best-seller pages (/mas-vendidos/MLMxxxx) currently redirect anonymous requests to MercadoLibre's account-verification wall (/gz/account-verification, served from the suspicious-traffic frontend). The actor detects this, records the URL/status/redirect target in the run summary, and moves on without retrying or solving anything.
• Pages deliberately avoided: search-result pages and product-detail pages are never fetched, because MercadoLibre redirects them to account verification for anonymous requests. Product URLs are recorded as plain strings only.
• sold_quantity is always null: the mas-vendidos surfaces do not publish a per-item sold count.
• Rate limiting: ~1 request/second between fetches; one bad page (timeout, block, parse error) never kills the run; records are deduplicated by product URL.

Data rules

• Public, logged-out listing pages only. No login flows, no stored session cookies, no CAPTCHA solving, no proxy services.
• No personal data is collected: no names, emails, or phone numbers of private individuals. Only public listing data (product titles, prices, images, URLs; seller or brand names appear only when printed on the public listing itself).