Mercado Libre / Mercado Livre Product Search Crawler

Crawls Mercado Libre/Livre search results across all supported regions and returns structured product data. No cookies or authentication required.

Input

Field	Type	Required	Default	Description
keyword	string	✅	—	Search keyword (e.g. iphone 15) or a full Mercado Libre/Livre search URL
region	string	❌	BR	Country code (see Supported Regions)
maxItems	integer	❌	40	Maximum number of products to return (1–500)
proxyUrl	string	❌	—	Residential proxy URL. Format: http://user:pass@host:port

Keyword or URL: You can pass either a plain search term or a full ML URL like https://lista.mercadolivre.com.br/example-keyword or https://listado.mercadolibre.com.ar/example-keyword. Category-filtered URLs are also supported.

Supported Regions

Code	Country	Site
AR	Argentina	listado.mercadolibre.com.ar
BO	Bolivia	listado.mercadolibre.com.bo
BR	Brazil	lista.mercadolivre.com.br
CL	Chile	listado.mercadolibre.cl
CO	Colombia	listado.mercadolibre.com.co
CR	Costa Rica	listado.mercadolibre.co.cr
DO	Dominican Republic	listado.mercadolibre.com.do
EC	Ecuador	listado.mercadolibre.com.ec
GT	Guatemala	listado.mercadolibre.com.gt
HN	Honduras	listado.mercadolibre.com.hn
MX	Mexico	listado.mercadolibre.com.mx
NI	Nicaragua	listado.mercadolibre.com.ni
PA	Panama	listado.mercadolibre.com.pa
PE	Peru	listado.mercadolibre.com.pe
PY	Paraguay	listado.mercadolibre.com.py
SV	El Salvador	listado.mercadolibre.com.sv
UY	Uruguay	listado.mercadolibre.com.uy
VE	Venezuela	listado.mercadolibre.com.ve

Output

Each item in the dataset has the following fields:

Field	Type	Description
itemId	string	ML item ID (e.g. MLB6172465976, MLA123456)
name	string	Product title
price	number	Current price in the local currency
priceOriginal	number | null	Original price before discount
discount	number | null	Discount percentage (0–100)
currency	string	Currency code (e.g. BRL, ARS, MXN)
installments	string | null	Installment description (e.g. 5x BRL 36,00 sem juros)
seller	string | null	Seller name
rating	number | null	Average rating (0–5)
thumbnail	string	Product image URL
images	string[]	Array with the thumbnail URL
url	string	Direct link to the product page
freeShipping	boolean	Whether the item ships for free
isSponsored	boolean	Whether the listing is a paid advertisement

Example dataset item

Each row in the Apify dataset is a single product:

{
  "itemId": "MLB0000000001",
  "name": "Example Product Name",
  "price": 179.99,
  "priceOriginal": 219.99,
  "discount": 18,
  "currency": "BRL",
  "installments": "5x BRL 36,00 sem juros",
  "seller": "Example Seller",
  "rating": 4.4,
  "thumbnail": "https://http2.mlstatic.com/D_000000-MLB00000000000_000000-O.jpg",
  "images": ["https://http2.mlstatic.com/D_000000-MLB00000000000_000000-O.jpg"],
  "url": "https://www.mercadolivre.com.br/example-product/p/MLB0000000001",
  "freeShipping": true,
  "isSponsored": false
}

Limits

• Max items per run: 500. Relevance degrades significantly beyond this.
• Total available: Mercado Libre caps search results at ~2000. The totalAvailable field reflects this.
• Sponsored listings are included by default. Filter them out using isSponsored: false in your downstream processing.

Notes

• No login required. Mercado Libre/Livre search is publicly accessible.
• Proxy: Datacenter IPs generally work fine. A residential proxy is only needed if you hit 503 bot detection errors.
• Sponsored URLs: Sponsored items use click-tracking URLs internally. The crawler automatically replaces these with direct product page links for the correct country.
• Default region: BR (Brazil). Existing integrations that omit region continue to work without changes.