MercadoLibre Search Scraper

🔎 Collect Mercado Libre search product data

MercadoLibre Search Scraper helps ecommerce teams, sellers, agencies, and researchers collect products from Mercado Libre and Mercado Livre search pages. Search by keyword or use a results URL, then get prices, sellers, shipping, ratings, images, and search positions in a clean dataset.

• Mercado Libre Price Monitoring — compare current prices, past prices, discounts, and shipping across repeat runs.
• Mercado Libre Product Rank Tracking — track where products appear for a keyword or results URL.
• Mercado Libre Competitor Analysis — compare visible products, sellers, prices, ratings, and placement.
• Mercado Libre Sponsored Listing Monitoring — review promoted and organic product placement when the source marks it.
• Mercado Libre Assortment Research — build product lists from search, category, and filtered results pages.
• Mercado Libre Seller Research — compare seller names and official-store status shown on product cards.
• Mercado Libre ZIP Code Search — check how product order, stock, or shipping text may change by delivery ZIP or postal code.

📦 Returned data

Each dataset row is one product shown on a Mercado Libre or Mercado Livre results page. Fields include:

• product identity: productId, title, url, and imageUrl
• search context: searchRank, pageNumber, sourceTarget, and sourceUrl
• market context: country, postalCode, and currency
• prices: currentPrice, previousPrice, discountPercent, and installmentsText
• seller and delivery data: sellerName, isOfficialStore, shippingText, and freeShipping
• product signals: rating, reviewCount, isSponsored, categoryId, and condition

Some values can be null when the source does not show them on the product card. The Actor does not guess missing values.

🚀 Running the Actor

1. Choose Keyword search or Results URLs as the Target.
2. Add keywords or Mercado Libre and Mercado Livre results URLs for that Target.
3. For keywords, choose a Market and sort order.
4. Add a delivery ZIP or postal code if location matters.
5. Set the product limit and first page.
6. Run the Actor and open the dataset.

Keyword searches support relevance, lowest-price, highest-price, and newest order. Results URLs can point to search, category, or filtered result pages. The Actor can save up to 5,000 products in one run. It skips product detail URLs and homepages because it reads results pages only.

⚙️ Input

Field	What it does
target	Chooses keywordSearch or resultsUrls.
targets	Product keywords used for the Keyword search Target.
startUrls	Search, category, or filtered results URLs used for the Results URLs Target.
country	Market used for keyword searches. A full URL keeps its own country domain.
sortBy	Order for keyword searches: relevance, low price, high price, or newest.
postalCode	Optional delivery ZIP or postal code for the results.
maxResults	Most products to save across the run.
startPage	First results page to read for each input.

This valid input runs a keyword search in Mexico:

{
  "target": "keywordSearch",
  "targets": ["iphone"],
  "country": "mx",
  "postalCode": "64000",
  "sortBy": "relevance",
  "maxResults": 96,
  "startPage": 1
}

📊 Output

A product row follows this shape. Optional fields vary with what the product card shows:

{
  "productId": "MLM1054106936",
  "title": "Apple iPhone 17 Pro Max (256 GB)",
  "url": "https://www.mercadolibre.com.mx/apple-iphone-17-pro-max/p/MLM1054106936",
  "searchRank": 1,
  "pageNumber": 1,
  "sourceTarget": "iphone",
  "sourceUrl": "https://listado.mercadolibre.com.mx/iphone",
  "country": "mx",
  "postalCode": "64000",
  "currency": "MXN",
  "currentPrice": 30998,
  "previousPrice": null,
  "discountPercent": null,
  "installmentsText": "12 meses sin intereses",
  "shippingText": "Llega gratis hoy",
  "freeShipping": true,
  "sellerName": "Apple",
  "isOfficialStore": false,
  "isSponsored": false,
  "rating": 4.9,
  "reviewCount": null,
  "imageUrl": "https://http2.mlstatic.com/D_NQ_NP_123456-MLM123456789.jpg",
  "categoryId": null,
  "condition": "Nuevo"
}

💳 Pricing

This Actor uses pay-per-event pricing. You are charged for each product saved to the dataset. Empty searches, skipped inputs, and products that are not saved do not create this product charge. Set Product limit to cap how many products can be saved and charged.

🔌 Integrations

Use Apify datasets to export JSON, CSV, Excel, XML, RSS, or HTML. You can also run the Actor with the Apify API, schedules, webhooks, Zapier, Make, Google Sheets, or other Apify integrations.

❓ FAQ

Can I use a product detail URL?

No. Use a search, category, or filtered results URL. Product detail URLs and marketplace homepages are skipped.

Why can a rating, seller, or shipping field be empty?

Mercado Libre does not show every value on every product card. The Actor leaves a value empty instead of reading it from unrelated text.

Why do results change by ZIP or postal code?

Product order, stock, and delivery text can depend on location. Add a delivery ZIP or postal code when you need that location context.

Does it collect product details, reviews, or Q&A?

No. It reads product cards on search and category results pages. It does not open product detail pages or collect review text, Q&A, full descriptions, or full photo galleries.

Do I need a Mercado Libre login or API key?

No buyer-supplied Mercado Libre login or API key is needed for the public results pages this Actor reads.

Should I use the official Mercado Libre API instead?

Use the official API when it gives you the fields and access you need. Use this Actor when you need the public product cards, their visible order, and card-level fields from supported results pages.

Can I continue from a later page?

Yes. Set startPage to begin on a later results page. This can help split or continue a search.

📝 Changelog

• 0.1: Added delivery ZIP/postal code support and improved search scraping.
• 0.0: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Mercado Libre Product Rank Checker — check the organic rank of one known product for chosen keywords.
• Allegro Scraper — collect product listings from another marketplace for cross-market research.
• Google Shopping Ads Scraper — compare paid Shopping products, prices, merchants, and ad positions.
• Trendyol Scraper — collect Trendyol products and optional reviews or answered Q&A.
• OLX Scraper — study prices and sellers in public classified listings.

Made with ❤️ by Maxime Dupré