# MercadoLibre Scraper - Products, Prices & Sellers (`bovi/mercadolibre-scraper`) Actor Scrape MercadoLibre product listings across all Latin-American sites (MLA Argentina, MLB Brazil, MLM Mexico, MLC Chile, MCO Colombia & more). Returns title, price, original price, currency, condition, seller, free shipping, category, attributes, location, permalink & images per item. No API key. - **URL**: https://apify.com/bovi/mercadolibre-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 listings 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 listings from [MercadoLibre](https://www.mercadolibre.com) — Latin America's #1 online marketplace — across **every country site** in one actor: Mexico (MLM), Argentina (MLA), Brazil (MLB / MercadoLivre), Chile (MLC), Colombia (MCO), Peru, Uruguay, and more. This **MercadoLibre scraper** returns rich, structured data per product — title, price, original price, currency, condition, seller, free shipping, category, attributes, location, permalink, and images — with **no API key, no OAuth, and no login**. Pay per result at **$3.00 per 1,000 listings**. ### MercadoLibre product data this scraper returns Each listing record contains the fields most teams need for pricing, sourcing, and market research: | Field | Description | |---|---| | `item_id` | MercadoLibre item ID (e.g. `MLM1234567890`) | | `title` | Product title | | `price` | Current selling price | | `original_price` | Strikethrough / "before" price | | `currency_id` | Currency (MXN, ARS, BRL, CLP, COP, …) | | `discount_pct` | Discount percentage (computed) | | `available_quantity` | Units available | | `sold_quantity` | Units sold | | `condition` | `new` or `used` | | `rating` | Average star rating (0–5) when shown | | `reviews_count` | Number of reviews when shown | | `installments` | Financing string when shown (e.g. "12x sin interés") | | `seller_id` / `seller_nickname` | Seller identity | | `seller_reputation` | Seller reputation level when shown | | `free_shipping` | Whether the listing offers free shipping | | `listing_type` | Listing tier when present | | `category_id` | MercadoLibre category ID | | `attributes` | Brand, model, and other item attributes | | `location_state` / `location_city` | Item location | | `permalink` | Canonical product URL | | `thumbnail` / `pictures` | Image URLs | | `site` / `country` | Source site (MLM/MLA/…) and country code | | `parse_confidence` / `warnings` | Data-quality score + drift flags | | `scraped_at` | ISO-8601 scrape timestamp | ### How to scrape MercadoLibre in any country Pick a **country site** and a search query, and the actor does the rest. It paginates the storefront automatically and pushes one clean record per product. - `site` — `MLM` (Mexico, default), `MLA` (Argentina), `MLB` (Brazil), `MLC` (Chile), `MCO` (Colombia), and 13 more. - `sites` — **scrape several countries in one run.** A list of site IDs; every query runs against each one (e.g. compare a price across Mexico, Argentina and Brazil at once). Leave empty to use the single `site`. - `query` — a single search term, like the MercadoLibre search bar. - `queries` — a list of searches run in sequence (batch competitive research). - `itemUrls` — specific product URLs or IDs for price monitoring. - `sellerUrls` — seller / official-store pages. ```json { "site": "MLM", "query": "iphone 15", "maxResults": 50 } ```` Compare one query across three countries in a single run: ```json { "sites": ["MLM", "MLA", "MLB"], "query": "iphone 15", "maxResults": 50 } ``` ### MercadoLibre data: use cases - **Price monitoring** — track price, discount, and stock changes for competitor SKUs across countries. - **Market research** — survey a category's pricing landscape, brand mix, and seller fragmentation. - **Arbitrage sourcing** — find discounted, high-demand items to resell across LATAM marketplaces. - **Seller intelligence** — profile sellers by reputation, range, and free-shipping policy. - **Repricing & feeds** — feed normalized MercadoLibre prices into a repricer or BI dashboard. ### Multi-country coverage (MLA, MLB, MLM, MLC, MCO and more) One actor, all 18 of MercadoLibre's marketplaces. The `site` input selects a single storefront; the `sites` input scrapes **several countries in one run**, routing each through a residential IP **in its own country** so every result reflects what a local shopper actually sees. Brazil (MercadoLivre, `lista.mercadolivre.com.br`, Portuguese) is fully supported alongside the Spanish-language sites — including its special domain and subdomain, which single-language scrapers get wrong. Run one query across MX + AR + BR and get a clean, side-by-side price comparison without launching three separate jobs. ### Why this MercadoLibre scraper is reliable MercadoLibre's public API is now OAuth-gated and rejects anonymous requests, and its storefront blocks datacenter IPs on search. This actor handles both realities: it reads the storefront's embedded **polycard JSON** with a structural-HTML fallback, and it routes through **Apify Residential Proxy** in the target country (billed to the run owner — no external proxy account, no key to paste). A built-in `parse_confidence` score and `warnings` list flag silent structure drift, so you catch breakage before it pollutes your dataset. #### A three-layer parser that keeps working when the page changes Marketplaces reshuffle their markup constantly, and most scrapers break the day they do. This one is built as a **guarded fallback chain**, each layer emitting a `parse_confidence` score: 1. **Polycard JSON** (primary) — the structured product objects embedded in the page. Fast and complete. 2. **Deep state walk** (B-plan) — if MercadoLibre renames the results wrapper key, the parser walks the embedded state tree and finds the largest array of product-shaped objects anywhere in it. A key rename no longer blinds the scraper. 3. **Structural HTML** (last resort) — when no JSON is present at all, it parses the result grid using stable structural anchors (`ui-search-layout__item`, `poly-card`, `andes-money-amount`), not brittle hashed CSS classes. On top of that, the actor **detects anti-bot interstitials** (the "account verification" / captcha pages) and rotates to a fresh residential IP before retrying, and it **never charges you for empty or low-confidence records** — a broken parse produces no garbage in your dataset and no charge on your bill. If a whole run is blocked, it fails loudly instead of handing you a silent empty dataset. ### Pricing Pay Per Result: **$3.00 per 1,000 listings** ($0.003 per record). You only pay for clean records the actor actually pushes. Platform/proxy usage is billed to your own Apify account at standard rates. ### Frequently asked questions **Do I need a MercadoLibre account or API key?** No. The actor reads the public storefront — no login, no OAuth, no token. **Which countries are supported?** All MercadoLibre sites: Mexico, Argentina, Brazil, Chile, Colombia, Peru, Uruguay, Venezuela, Ecuador, Bolivia, and the Central-American sites — selected via the `site` input. **Do I need a proxy?** Yes for search — MercadoLibre blocks datacenter IPs. The actor defaults to Apify Residential Proxy in the site's country; just leave the proxy input on its default. It is billed to your Apify account. **Can I look up specific products?** Yes — pass product URLs or item IDs (e.g. `MLM1234567890`) in `itemUrls`. **What does `parse_confidence` mean?** `1.0` means all critical fields parsed cleanly. Records below `0.5`, or missing both an ID and a price, are dropped before the dataset — you are never charged for them. Check `warnings` for the specific drift codes. **Why is there no monthly fee?** This actor is pure pay-per-result — you pay only for listings actually delivered. There is no rental or subscription on top. ### Disclaimer MercadoLibre is a public marketplace. This actor accesses the same publicly visible storefront pages any shopper can browse, and extracts only publicly available listing data. # Actor input Schema ## `site` (type: `string`): Which MercadoLibre country site to scrape. Determines the storefront, currency, language, and the proxy country. Ignored when 'Country sites (multi)' is set. ## `sites` (type: `array`): Scrape SEVERAL MercadoLibre countries in ONE run — every query runs against each site you list (e.g. compare iPhone prices across Mexico, Argentina & Brazil at once). Use MercadoLibre site IDs: MLM, MLA, MLB, MLC, MCO, MLU, MPE, MLV, MEC, MBO, MGT, MPA, MRD, MPY, MNI, MHN, MSV, MCR. Leave empty to use the single 'Country site' above. ## `query` (type: `string`): A single search query to run on the chosen MercadoLibre site (e.g. 'iphone 15', 'notebook gamer', 'zapatillas nike'). Works like the MercadoLibre search bar. Use 'queries' for multiple searches. ## `queries` (type: `array`): List of search queries to run in sequence. Each query is scraped independently up to Max results. Use this for batch competitive research or catalog monitoring. ## `itemUrls` (type: `array`): List of MercadoLibre product URLs (https://articulo.mercadolibre.com.mx/MLM-...) or raw item IDs (e.g. MLM1234567890) to look up directly. Use for price monitoring of specific SKUs. ## `sellerUrls` (type: `array`): List of MercadoLibre seller or official-store URLs to scrape as listing pages. ## `maxResults` (type: `integer`): Maximum listings to return per query. MercadoLibre returns ~48 per page; the actor paginates automatically. Keep this low to control cost. ## `proxyConfiguration` (type: `object`): MercadoLibre blocks datacenter IPs on search, so an Apify RESIDENTIAL proxy in the site's country is REQUIRED for reliable results. Leave default to auto-select RESIDENTIAL in the matching country. Billed to the run owner; no external proxy account needed. ## Actor input object example ```json { "site": "MLM", "query": "iphone", "maxResults": 50, "proxyConfiguration": { "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 = { "site": "MLM", "query": "iphone", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/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 = { "site": "MLM", "query": "iphone", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("bovi/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 '{ "site": "MLM", "query": "iphone", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call bovi/mercadolibre-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/mercadolibre-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "MercadoLibre Scraper - Products, Prices & Sellers", "description": "Scrape MercadoLibre product listings across all Latin-American sites (MLA Argentina, MLB Brazil, MLM Mexico, MLC Chile, MCO Colombia & more). Returns title, price, original price, currency, condition, seller, free shipping, category, attributes, location, permalink & images per item. No API key.", "version": "0.1", "x-build-id": "9UqYMvttBuqLDt0fo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~mercadolibre-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-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/bovi~mercadolibre-scraper/runs": { "post": { "operationId": "runs-sync-bovi-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/bovi~mercadolibre-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-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": { "site": { "title": "Country site", "enum": [ "MLM", "MLA", "MLB", "MLC", "MCO", "MLU", "MPE", "MLV", "MEC", "MBO", "MGT", "MPA", "MRD", "MPY", "MNI", "MHN", "MSV", "MCR" ], "type": "string", "description": "Which MercadoLibre country site to scrape. Determines the storefront, currency, language, and the proxy country. Ignored when 'Country sites (multi)' is set.", "default": "MLM" }, "sites": { "title": "Country sites (multi)", "type": "array", "description": "Scrape SEVERAL MercadoLibre countries in ONE run — every query runs against each site you list (e.g. compare iPhone prices across Mexico, Argentina & Brazil at once). Use MercadoLibre site IDs: MLM, MLA, MLB, MLC, MCO, MLU, MPE, MLV, MEC, MBO, MGT, MPA, MRD, MPY, MNI, MHN, MSV, MCR. Leave empty to use the single 'Country site' above.", "items": { "type": "string" } }, "query": { "title": "Search query", "type": "string", "description": "A single search query to run on the chosen MercadoLibre site (e.g. 'iphone 15', 'notebook gamer', 'zapatillas nike'). Works like the MercadoLibre search bar. Use 'queries' for multiple searches." }, "queries": { "title": "Search queries (list)", "type": "array", "description": "List of search queries to run in sequence. Each query is scraped independently up to Max results. Use this for batch competitive research or catalog monitoring.", "items": { "type": "string" } }, "itemUrls": { "title": "Item URLs or IDs", "type": "array", "description": "List of MercadoLibre product URLs (https://articulo.mercadolibre.com.mx/MLM-...) or raw item IDs (e.g. MLM1234567890) to look up directly. Use for price monitoring of specific SKUs.", "items": { "type": "string" } }, "sellerUrls": { "title": "Seller / store URLs", "type": "array", "description": "List of MercadoLibre seller or official-store URLs to scrape as listing pages.", "items": { "type": "string" } }, "maxResults": { "title": "Max results per query", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum listings to return per query. MercadoLibre returns ~48 per page; the actor paginates automatically. Keep this low to control cost.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "MercadoLibre blocks datacenter IPs on search, so an Apify RESIDENTIAL proxy in the site's country is REQUIRED for reliable results. Leave default to auto-select RESIDENTIAL in the matching country. Billed to the run owner; no external proxy account needed.", "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 } } } } } } } } } } ```