Mercado Libre Search Results Scraper

🔎 Collect Mercado Libre search product data

Mercado Libre Search Results 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. Get prices, sellers, shipping, ratings, images, and search positions in a clean dataset.

• Compare prices, discounts, and shipping over time with Mercado Libre price monitoring.
• Collect product fields from search pages with the Mercado Libre search scraper.
• Track where products appear with Mercado Libre product rank tracking.
• Compare visible products, sellers, ratings, and placement with Mercado Libre competitor analysis.
• Review promoted and organic placement with Mercado Libre sponsored listing monitoring.
• Build product lists from search, category, and filtered pages with Mercado Libre assortment research.
• Compare seller names and official-store status with Mercado Libre seller research.
• See how location may change product order and shipping with Mercado Libre ZIP code search.

📦 Mercado Libre product-card data

Each dataset row is one product card from a Mercado Libre or Mercado Livre results page. It can include product details, price, seller, shipping, ratings, search rank, sponsored status, and visible variations. Some values are null when the card does not show them. The Actor does not guess missing values.

When the same product appears more than once, the Actor saves its first eligible match and ignores later matches.

🚀 Run a Mercado Libre search

1. Choose Keyword search or Search or category pages in Find products by.
2. Add keywords or search, category, or filtered results URLs.
3. For keywords, choose a market and sort order.
4. Add a delivery ZIP or postal code if location matters.
5. Set filters and a product limit if you need them.
6. Run the Actor and open the dataset.

Keyword searches can use relevance, lowest price, highest price, or newest order. For Search or category pages, use public search, category, or filtered results pages. Leave Product limit empty or set it to 0 to save all available product cards. It reads results pages, not product detail pages or homepages.

⚙️ Input

Input fields

Field	Type	What it does
target	string	Chooses keywordSearch (Keyword search) or resultsUrls (Search or category pages). Options for the other choice are ignored. Location, product limit, and filters apply to both.
targets	string array	Sets one or more product keywords for keywordSearch.
startUrls	object array	Sets search, category, or filtered results URLs for resultsUrls. Each object contains a url.
startUrls[].url	string	Sets one search, category, or filtered results URL inside a startUrls object.
country	string	Sets the marketplace for keyword searches. A full results URL keeps its own country domain.
sortBy	string	Orders keyword results by relevance, low price, high price, or newest.
postalCode	string	Applies a delivery ZIP or postal code. Leave it empty for general market results.
maxResults	integer	Stops after this many products are saved across all keywords or URLs. Leave it empty or enter 0 to return all available products. The form starts with 5.
condition	string	Chooses any, new, or used to filter cards by condition.
minPrice	number	Keeps cards at or above this amount in the local market currency. Leave it empty for no minimum.
maxPrice	number	Keeps cards at or below this amount in the local market currency. Use a value at least as high as minPrice. Leave it empty for no maximum.
freeShipping	boolean	Keeps only listings that advertise free shipping when true.
officialStore	boolean	Keeps only listings marked as marketplace official stores when true.

Default input

This input comes from the successful current-beta run used for the product-row example:

{
  "maxResults": 5,
  "target": "keywordSearch",
  "targets": [
    "iphone"
  ],
  "country": "mx",
  "sortBy": "relevance",
  "condition": "any"
}

🧾 Output

Output fields

Field	Type	What it does
productId	string	Mercado Libre product ID for the listing.
title	string	Product title shown on the card.
url	string	Public Mercado Libre or Mercado Livre page for the product.
imageUrl	string or null	Main product image URL.
searchRank	integer	One-based position for the submitted target.
pageNumber	integer	Results page where the product was found.
sourceTarget	string	Keyword or URL whose first eligible match saved the row.
sourceUrl	string	Results page where the product was found.
country	string	Two-letter marketplace country code.
currency	string	Currency code for the current price.
currentPrice	number	Current price shown on the card.
previousPrice	number or null	Earlier price shown for a promotion.
discountPercent	number or null	Discount percentage shown on the card.
installmentsText	string or null	Visible installment or payment text.
shippingText	string or null	Visible shipping or delivery text.
freeShipping	boolean or null	Whether the card says shipping is free.
sellerName	string or null	Visible seller or official-store name.
isOfficialStore	boolean	Whether the card marks an official store.
isSponsored	boolean	Whether source markup marks the product as sponsored.
rating	number or null	Product rating, when shown.
reviewCount	integer or null	Review or rating count, when shown.
categoryId	string or null	Mercado Libre category ID, when available.
condition	string or null	Product condition, when shown.
variations	object array	Choices shown on the card, such as colors or styles. Each choice has only its name.
variations.label	string or null	Visible choice name.

Example product row

This is the first full row from the same successful current-beta default-input run:

{
  "productId": "MLM1027172667",
  "title": "Apple iPhone 15 (128 GB) - Azul - Distribuidor Autorizado",
  "url": "https://mercadolibre.com.mx/p/MLM1027172667",
  "searchRank": 1,
  "pageNumber": 1,
  "sourceTarget": "iphone",
  "sourceUrl": "https://listado.mercadolibre.com.mx/iphone",
  "country": "mx",
  "currency": "MXN",
  "currentPrice": 16225,
  "previousPrice": null,
  "discountPercent": null,
  "installmentsText": "15 meses sin intereses de $1,081",
  "shippingText": "Llega gratis mañana",
  "freeShipping": true,
  "sellerName": "Apple",
  "isOfficialStore": true,
  "isSponsored": true,
  "rating": 4.9,
  "reviewCount": 1971,
  "imageUrl": "https://http2.mlstatic.com/D_Q_NP_2X_952616-MLA95935522561_102025-E.webp",
  "categoryId": "MLM1055",
  "condition": null,
  "variations": []
}

💳 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. If your run reaches its maximum charge limit, it stops and keeps the products saved so far.

🔌 Integrations

Export Apify datasets as JSON, CSV, Excel, XML, RSS, or HTML. You can also use the Apify API, schedules, webhooks, Zapier, Make, Google Sheets, and 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 guessing it.

Why do results change by ZIP or postal code?

Product order, availability, and shipping 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 results pages. It does not collect full descriptions, full image galleries, specifications, stock, units sold, seller reputation, review text, Q&A, or details not shown on the card.

Do I need a Mercado Libre login or API key?

No 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 public product cards, visible order, and card-level fields from results pages.

📝 Changelog

v2.0 (31-10-2026)

• Each item in variations now has only label. The id and imageUrl fields inside variations were removed, with no replacement. Update any tools that read them.
• A resumed run no longer saves or charges the same product twice.
• searchRank now follows each product's card position on the results pages.
• Prices now keep their cents.
• The Official stores only filter now works in Brazil.
• rating is now null for products with no reviews.
• Results URLs outside Mercado Libre and Mercado Livre are now skipped with a warning.
• The run now stops with a clear message when the minimum price is above the maximum price.
• Enter 0 in Product limit to collect all available products.
• Reliability improvements.

v1.0 (08-10-2026)

• The url field for sponsored listings now points to public Mercado Libre or Mercado Livre product pages.
• Keyword searches now support Colombia.
• Ratings now match more product listings when Mercado Libre shows them.
• Saved rows now require a product ID and no longer include a delivery postal code.
• The startPage input was removed. Searches begin on page 1.

v0.2

• Added a Results URLs target for search, category, and filtered results pages.
• Added condition, price, free-shipping, and official-store filters.
• Leave Product limit empty to collect all available product cards.

v0.1

• Added delivery ZIP/postal code support.
• Improved product collection from searches.

v0.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 a known product for chosen keywords.
• MercadoLibre Phone Number Scraper: find public seller phone numbers and emails on the same marketplace.
• 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 products from another marketplace with optional reviews and Q&A.

Made with ❤️ by Maxime Dupré