Mercado Libre Search Scraper

Mercado Libre Search Scraper

Search Mercado Libre and Mercado Livre by keyword, search URL, or category results URL. Get clean product rows with title, price, rank, seller, shipping text, rating, image, delivery ZIP context, and source URL so you can study a market without copying cards by hand.

The fastest first run is already filled in: keep iphone, keep Mexico as the market, and run the Actor. You can raise or lower the product limit before you start.

What This Actor Does

Mercado Libre Search Scraper turns search result pages into an Apify dataset. Use it when you need product search data for price checks, market research, stock checks, rank tracking, seller lists, or ecommerce lead work.

You can enter:

• Plain search terms, such as iphone, nike shoes, or air fryer
• Mercado Libre search URLs
• Mercado Livre search URLs from Brazil
• Category and results-page URLs
• Mixed batches of searches and URLs

For plain search terms, choose the market in the input form. For full Mercado Libre or Mercado Livre URLs, the Actor uses the URL's own country domain.

You can also provide a delivery ZIP or postal code when you want rankings, availability, and shipping promises to match a specific location.

Data You Get

Each output row is one product card from search results. Rows are flat, so they are easy to export to CSV, JSON, Excel, Google Sheets, webhooks, or your own API workflow.

The dataset can include:

• Product title and URL
• Product or item ID when shown
• Search rank and page number
• Search term or URL that found the product
• Mercado Libre site code, country, postal code, and currency
• Current price, old price, and discount percent
• Installment and shipping text
• Seller or official store name
• Official store and sponsored flags
• Rating and review count
• Main image URL
• Category ID when it is visible
• Scrape time

Some fields can be empty when Mercado Libre does not show that data on the search card.

Why Use It

Use this Actor to:

• Track how products rank for search terms
• Compare prices across sellers and markets
• Watch discount and shipping text at scale
• Build product lists for ecommerce research
• Find official stores and sponsored products
• Feed clean Mercado Libre search data into BI tools, scripts, or alerts

How To Run

1. Add one or more searches or Mercado Libre URLs.
2. Pick a market for plain search terms.
3. Add a delivery ZIP or postal code if you need location-specific results.
4. Set the product limit.
5. Choose the sort order if you use search terms.
6. Run the Actor and open the dataset.

You can schedule runs on Apify, call the Actor from the API, export the dataset, or connect it to other Apify integrations.

Input

Searches or URLs

Enter search terms or paste Mercado Libre search, category, and results-page URLs. Product detail URLs and homepages are skipped because this Actor emits rows from search result cards, not item detail pages or general entry pages. You can mix both in one run.

Market

This is used only for plain search terms. Full URLs keep their own Mercado Libre or Mercado Livre domain.

Delivery ZIP/Postal Code

Optional. Set this when search results should use a specific delivery location. Mercado Libre may change ranking, availability, and shipping text based on this value.

Product Limit

The maximum number of products to save across all searches and URLs in the run. The default is 48.

Sort Products By

Use relevance, low-to-high price, or high-to-low price for plain search terms. Full URLs keep their own source sort when possible.

Start Page

Start from a later search page when you want to continue a past run or skip the first page.

Output Example

{
  "productId": "MLM1054106937",
  "title": "Apple iPhone 17 Pro Max",
  "url": "https://www.mercadolibre.com.mx/...",
  "searchRank": 1,
  "pageNumber": 1,
  "sourceTarget": "iphone",
  "country": "mx",
  "site": "MLM",
  "postalCode": "64000",
  "currency": "MXN",
  "currentPrice": 30898,
  "sellerName": "Apple",
  "isOfficialStore": true,
  "isSponsored": false,
  "rating": 4.9,
  "reviewCount": 120,
  "imageUrl": "https://http2.mlstatic.com/...",
  "scrapedAt": "2026-05-18T00:00:00.000Z"
}

Pricing

This Actor uses pay-per-event pricing. Each run has a small Actor start charge, then a charge for each Mercado Libre product saved to the dataset. Set Product limit to control run size and cost before you start.

Notes And Limits

Mercado Libre can change what it shows by market, page, or product type. The Actor saves fields that are visible in search results; homepages, product detail pages, reviews, Q&A, seller catalog pages, and checkout data are outside this Actor. If you paste an unsupported URL, the Actor skips it with a clear warning before scraping starts.

FAQ

Does This Scrape Mercado Livre In Brazil?

Yes. Choose Brazil for plain search terms or paste a Mercado Livre URL.

Why Do Results Change By ZIP Or Postal Code?

Mercado Libre can personalize search results, delivery promises, and availability by location. Add a delivery ZIP or postal code when you need the Actor to match a specific location instead of Mercado Libre's inferred default.

Can I Use Mercado Libre Category URLs?

Yes. Paste a category or results-page URL into the searches field.

Does It Scrape Product Detail Pages?

No. This Actor is focused on search result and category result cards. Product detail URLs are skipped before scraping starts.

Can I Use A Mercado Libre Homepage?

No. Paste a search, category, or results-page URL instead. Homepage URLs are skipped before scraping starts because they are not a specific results surface.

Can I Export The Data?

Yes. Apify datasets can be exported as JSON, CSV, Excel, RSS, XML, and HTML, and can be used from the Apify API.

What If A Field Is Empty?

Some product cards do not show every field. Empty values mean that field was not shown on the search card for that product.

Actor Release Notes

0.1: Delivery ZIP support

Added an optional delivery ZIP/postal code input so runs can match location-specific Mercado Libre rankings, availability, and shipping promises. Output rows now include the applied postal code for easier auditing.

0.0: Initial release

Search Mercado Libre and Mercado Livre by keyword, search URL, category URL, or results-page URL, with product rows for prices, sellers, shipping text, ratings, images, and rank.

Support

If a run does not return the products you expected, open an issue from the Actor page and include the input you used, the market, and the run ID. This makes it much easier to check the source page and help you quickly.