# MercadoLibre Scraper - Products, Prices & Reviews (`memo23/mercadolibre-scraper`) Actor Scrape MercadoLibre across 7 LATAM countries — product title, price, condition, rating, images and individual reviews. Search by keyword, category URL or product URL. Solves the proof-of-work bot gate for you. JSON or CSV, pay per result - **URL**: https://apify.com/memo23/mercadolibre-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** E-commerce, AI, Agents - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 product results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## MercadoLibre Scraper Scrape product data from **MercadoLibre** across Latin America — title, price, condition, rating, review count, seller and images. Search by keyword, paste a category listing URL, or a direct product URL. The actor **solves MercadoLibre's proof-of-work bot gate for you** and returns clean structured rows. Seven country sites, pay per result, no monthly fee. #### How it works ![How the MercadoLibre Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-mercadolibre.png) #### ✨ Why use this scraper? - **Beats the bot gate.** MercadoLibre fronts search/listing pages with a JavaScript proof-of-work challenge; this actor solves it server-side (no browser) and retries across residential IPs until it gets through — you just get the data. - **7 country sites in one actor.** Mexico, Argentina, Brazil, Colombia, Chile, Uruguay and Peru — prices returned in each site's currency. - **Three ways in.** Keyword search, category/listing URL, or direct product URL — mixed freely in one run, auto-classified per entry. - **Clean canonical URLs.** Sponsored/ad cards are de-duplicated to their real `/p/MLM…` product URLs, not click-tracking links. - **Optional full detail.** Turn on `enrichDetail` to add brand, rating, review count, condition and the image gallery from each product page. - **Pay per result.** Billed per product row with a strict `maxItems` cap, so a run never collects (or charges) more than you set. #### 🎯 Use cases | You are… | Use it to… | |---|---| | **Pricing / competitive intelligence** | Track competitor prices and availability across LATAM marketplaces | | **Resellers & dropshippers** | Source products, monitor prices and stock, sync catalogs | | **Market research** | Measure assortment, pricing and ratings by country and category | | **Brand monitoring** | Watch how your products are listed, priced and rated by third-party sellers | | **Deal / price monitors** | Track price drops on specific products on a schedule | #### 📥 Supported inputs | Input | Example | What you get | |---|---|---| | Search keyword (`searchTerms`) | `iphone` | Search results on the chosen country site | | Category / listing URL | `https://listado.mercadolibre.com.mx/celulares` | Every product in that listing | | Product URL | `https://www.mercadolibre.com.mx/p/MLM123456` | That single product | | Country | `MLM` / `MLA` / `MLB` / `MCO` / `MLC` / `MLU` / `MPE` | Which site to search | **Not supported:** seller back-office data, checkout, or anything behind a MercadoLibre account login. #### 🔄 How it works 1. **Classify** — each entry is tagged as a keyword search, a category listing, or a product URL. 2. **Fetch + solve** — pages are fetched over HTTP with a real Chrome TLS fingerprint; when the proof-of-work gate appears, the actor solves `sha256(nonce + r)` and replays the solution cookies. 3. **Paginate** — listings walk `_Desde_N` pages until empty or `maxItems`. 4. **Parse** — product cards (and, with `enrichDetail`, each product page's JSON-LD) are mapped to one normalized row. 5. **Push** — one row per product to the dataset (JSON or CSV), de-duplicated by canonical URL. #### ⚙️ Input parameters | Field | Type | Description | |---|---|---| | `searchTerms` | array | Keywords to search on the selected country site. | | `startUrls` | array | Listing URLs, product URLs, or bare keywords — auto-classified. | | `country` | string | Country site: `MLM` (default), `MLA`, `MLB`, `MCO`, `MLC`, `MLU`, `MPE`. | | `enrichDetail` | boolean | Fetch each product page for brand, rating, condition and images (slower). Default `false`. | | `maxReviews` | integer | Also scrape up to N recent reviews per product (rating, text, date). `0` = off. | | `maxItems` | integer | Hard cap on products collected (and billed). Default `1000`. | | `maxConcurrency` | integer | Parallel jobs (kept low — each request solves a challenge). Default `4`. | | `proxy` | object | Proxy configuration. **Residential strongly recommended.** | #### 📊 Output overview One row per product, identical shape across every country site and discovery mode. Search/category rows carry the essentials (title, price, currency, canonical URL, image); with `enrichDetail` each row is enriched from its product page (brand, condition, rating, review count, full images); with `maxReviews` each row also carries up to N recent individual reviews. Export as JSON or CSV. #### 📦 Output sample A real row (search on MLM, `enrichDetail` on): ```json { "type": "product", "site": "MLM", "country": "com.mx", "productId": "MLM1018500844", "title": "Apple iPhone 13 128 GB Medianoche", "url": "https://www.mercadolibre.com.mx/p/MLM1018500844", "price": 12999, "currency": "MXN", "brand": "Apple", "available": true, "rating": 4.9, "reviewCount": 7945, "reviews": [ { "rating": 4, "text": "Es original, llegó rápido y bien empacado.", "date": "Hace 8 meses" } ], "primaryImage": "https://http2.mlstatic.com/D_NQ_NP_2X_...-F.webp", "images": ["https://http2.mlstatic.com/D_NQ_NP_2X_...-F.webp"], "discoveryMode": "search", "sourceUrl": "https://listado.mercadolibre.com.mx/iphone", "scrapedAt": "2026-06-27T06:30:00.000Z" } ```` #### 🗂 Key output fields | Group | Fields | |---|---| | **Identity** | `productId`, `title`, `url`, `site`, `country` | | **Pricing** | `price`, `currency` | | **Detail** (with `enrichDetail`) | `brand`, `condition`, `available`, `rating`, `reviewCount` | | **Reviews** (with `maxReviews`) | `reviews[]` — each `rating`, `text`, `date` | | **Media** | `primaryImage`, `images[]` | | **Provenance** | `discoveryMode`, `sourceUrl`, `scrapedAt` | #### ❓ FAQ **Does it get past MercadoLibre's bot protection?** Yes — listing and product pages are gated by a JavaScript proof-of-work challenge. The actor solves it server-side and retries across IPs, so you don't need a browser or a CAPTCHA solver. **Do I need a proxy?** Yes — use **residential** (the default). MercadoLibre blocks datacenter IPs outright, and the gate is served unevenly across IPs, so the actor relies on residential rotation. **Which countries are supported?** Mexico, Argentina, Brazil, Colombia, Chile, Uruguay and Peru. Set `country` to the matching site code. **How do I get brand, rating and condition?** Enable `enrichDetail`. It fetches each product's page (one extra request per product) and reads its structured data. **Can I scrape individual reviews?** Set `maxReviews` to N — each product then includes up to N recent reviews (`rating`, `text`, `date`). Works with or without `enrichDetail`. Reviews are billed per review grabbed. **Why are some fields null in search mode?** Without `enrichDetail`, rows come from the fast listing cards (title, price, URL, image). Brand/rating/condition live on the product page. #### 💬 Support Hit a country site or page layout that doesn't parse? Open an issue with the URL you tried — most fixes are quick. #### 🛠 Additional services Need a custom field, scheduled price monitoring, or another MercadoLibre country/section? Reach out for a tailored build. #### 🔎 Explore more scrapers Pairs well with other marketplace and DTC product scrapers for broader e-commerce coverage. *** ### ⚠️ Disclaimer This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by MercadoLibre, Inc. or any of its subsidiaries. All trademarks are the property of their respective owners. The scraper accesses only publicly available product and listing pages — no authenticated endpoints, seller dashboards, or account data. Users are responsible for ensuring their use complies with MercadoLibre's Terms of Service, applicable data-protection law (LGPD, GDPR, CCPA, etc.), and any contractual obligations of their own organisation. *** ### SEO Keywords mercadolibre scraper, mercado libre scraper, mercadolivre scraper, mercadolibre api, scrape mercadolibre, mercadolibre product scraper, mercadolibre price scraper, mercadolibre mexico scraper, mercadolibre argentina scraper, mercadolibre brasil scraper, mercadolibre colombia scraper, latam ecommerce scraper, marketplace price monitoring, mercadolibre data extraction, apify mercadolibre, product listing scraper, competitor price tracker latam, mercadolibre seller data, ecommerce product scraper, mercadolibre json csv # Actor input Schema ## `searchTerms` (type: `array`): Keywords searched on the selected country site (e.g. `iphone`, `notebook gamer`). ## `startUrls` (type: `array`): MercadoLibre search or category listing URLs, direct product URLs (…/p/MLM…), or bare keywords. Each entry is auto-classified. ## `country` (type: `string`): Which MercadoLibre country site to search. ## `enrichDetail` (type: `boolean`): For each result, fetch its product page to add brand, rating, condition and full image gallery. Adds requests, so it's off by default. ## `maxReviews` (type: `integer`): Also scrape up to this many recent reviews per product (rating, text, date). 0 = off. Adds one request per product. ## `maxItems` (type: `integer`): Hard cap on products collected (and billed). ## `maxConcurrency` (type: `integer`): Parallel jobs. Kept low because each request solves a proof-of-work challenge. ## `proxy` (type: `object`): Residential proxy strongly recommended — MercadoLibre blocks datacenter IPs. ## Actor input object example ```json { "searchTerms": [ "iphone" ], "startUrls": [], "country": "MLM", "enrichDetail": false, "maxReviews": 0, "maxItems": 1000, "maxConcurrency": 4, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "iphone" ], "startUrls": [], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/mercadolibre-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["iphone"], "startUrls": [], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("memo23/mercadolibre-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "iphone" ], "startUrls": [], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call memo23/mercadolibre-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=memo23/mercadolibre-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "MercadoLibre Scraper - Products, Prices & Reviews", "description": "Scrape MercadoLibre across 7 LATAM countries — product title, price, condition, rating, images and individual reviews. Search by keyword, category URL or product URL. Solves the proof-of-work bot gate for you. JSON or CSV, pay per result", "version": "0.0", "x-build-id": "wYum25lZ5JMQSGLCM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~mercadolibre-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-mercadolibre-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/memo23~mercadolibre-scraper/runs": { "post": { "operationId": "runs-sync-memo23-mercadolibre-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/memo23~mercadolibre-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-mercadolibre-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Keywords searched on the selected country site (e.g. `iphone`, `notebook gamer`).", "items": { "type": "string" } }, "startUrls": { "title": "Listing / category / product URLs", "type": "array", "description": "MercadoLibre search or category listing URLs, direct product URLs (…/p/MLM…), or bare keywords. Each entry is auto-classified.", "items": { "type": "string" } }, "country": { "title": "Country site", "enum": [ "MLM", "MLA", "MLB", "MCO", "MLC", "MLU", "MPE" ], "type": "string", "description": "Which MercadoLibre country site to search.", "default": "MLM" }, "enrichDetail": { "title": "Fetch full product detail (slower)", "type": "boolean", "description": "For each result, fetch its product page to add brand, rating, condition and full image gallery. Adds requests, so it's off by default.", "default": false }, "maxReviews": { "title": "Reviews per product", "minimum": 0, "maximum": 50, "type": "integer", "description": "Also scrape up to this many recent reviews per product (rating, text, date). 0 = off. Adds one request per product.", "default": 0 }, "maxItems": { "title": "Maximum products", "minimum": 1, "type": "integer", "description": "Hard cap on products collected (and billed).", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel jobs. Kept low because each request solves a proof-of-work challenge.", "default": 4 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy strongly recommended — MercadoLibre blocks datacenter IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```