Mercado Livre Product Search Crawler

Crawls Mercado Livre Brazil search results 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 Livre search URL
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/shadow-of-the-colossus. Category-filtered URLs are also supported.

Output

Each item in the dataset has the following fields:

Field	Type	Description
itemId	string	ML item ID (e.g. MLB6172465976)
name	string	Product title
price	number	Current price in BRL
priceOriginal	number | null	Original price before discount
discount	number | null	Discount percentage (0–100)
currency	string	Always BRL
installments	string | null	Installment description (e.g. 5x R$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 output

{
  "itemId": "MLB6172465976",
  "name": "Jogo Shadow Of The Colossus Ps4 Midia Fisica - Excelente (Recondicionado)",
  "price": 179.99,
  "priceOriginal": null,
  "discount": null,
  "currency": "BRL",
  "installments": "5x R$36,00 sem juros",
  "seller": null,
  "rating": 4.4,
  "thumbnail": "https://http2.mlstatic.com/D_704999-MLB92315710845_092025-O.jpg",
  "images": ["https://http2.mlstatic.com/D_704999-MLB92315710845_092025-O.jpg"],
  "url": "https://www.mercadolivre.com.br/jogo-shadow-of-the-colossus-ps4-midia-fisica-excelente-recondicionado/p/MLB2020944462",
  "freeShipping": true,
  "isSponsored": false
}

Limits

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

Notes

• No login required. Mercado Livre's 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 produto.mercadolivre.com.br links.