# MercadoLivre Deals Scraper (`riseandcode/apify-mercadolivre-deals`) Actor Scrape every deal from MercadoLivre's "Ofertas do Dia" page into structured JSON — title, current & original price, discount %, coupon, seller, official-store badge, rating, installments, and shipping (incl. Full). Run once or schedule it daily to track promotions automatically. No code required. - **URL**: https://apify.com/riseandcode/apify-mercadolivre-deals.md - **Developed by:** [Rise and Code](https://apify.com/riseandcode) (community) - **Categories:** E-commerce, Other, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.70 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ### What does this MercadoLivre deals scraper do? This Actor scrapes the **[MercadoLivre "Ofertas do Dia"](https://www.mercadolivre.com.br/ofertas)** (daily deals, or _promoções_) page — Brazil's largest e-commerce marketplace — and returns clean, structured JSON for every deal and promotion on offer. For each discounted product you get the **title, current price, original price, discount percentage, deal type (Oferta do Dia / Relâmpago), seller, rating, installments, and shipping info**. Run it once or schedule it daily to track MercadoLivre promotions automatically, with API access, proxy rotation, and monitoring built in on the Apify platform. ### Why scrape MercadoLivre daily deals? - 🔥 **Deal monitoring** — capture every promotion the moment it goes live and react before stock runs out. - 💸 **Price intelligence** — compare deal prices against original prices to measure real discount depth across categories. - 🛒 **Competitor research** — see which sellers and products MercadoLivre is pushing in its featured deals. - 📈 **Repricing & arbitrage** — feed live deal prices into your own pricing or sourcing workflows. - 📊 **Market trends** — aggregate daily deals over time to spot seasonal patterns and category demand. - 🤖 **Automation** — schedule runs and push results into spreadsheets, databases, or dashboards through Apify integrations. ### Looking for a specific product instead of daily deals? This Actor returns whatever MercadoLivre is promoting on its Ofertas do Dia page — you can't search it by keyword. To scrape listings for a specific product, brand, or search term, use our **[MercadoLivre Search Scraper](https://apify.com/riseandcode/apify-mercadolivre-search)** instead. ### How to use this MercadoLivre deals scraper 1. Open the Actor on Apify and click **Try for free**. 2. In the **Input** tab, set **Max Items** to how many deals you want to collect. 3. Optionally pick a **Category** to limit the deals to a single department (or leave it on _Todas as categorias_ for everything). 4. Click **Start** and wait for the run to finish. 5. Open the **Output** tab or download the dataset as **JSON, CSV, Excel, or HTML**. To trigger a run via the Apify API: ```bash curl -X POST \ "https://api.apify.com/v2/acts//runs?token=" \ -H "Content-Type: application/json" \ -d '{ "maxItems": 200, "category": "all" }' ```` ### Input Configure the Actor in the **Input** tab or via JSON. | Field | Type | Default | Description | | ---------- | --------- | ------- | -------------------------------------------------------------------------------------------------------------- | | `maxItems` | `integer` | `48` | Maximum number of deals to scrape (48–1000). The deals page serves 48 per page, so 48 is one full page; higher values paginate 48 at a time until reached or the deals run out. | | `category` | `string` | `"all"` | MercadoLivre category to restrict deals to (e.g. `MLB1051` for Celulares). Use `"all"` for no category filter. | Example input: ```json { "maxItems": 200, "category": "MLB1051" } ``` The category dropdown includes the most popular MercadoLivre departments. Each value is a MercadoLivre category ID (`MLBxxxx`); advanced users can pass any valid category ID via the API. ### Output One dataset record is pushed per deal. Download the dataset as **JSON, CSV, Excel, or HTML** from the **Output** tab or via the Apify API. #### Output example ```json [ { "position": 1, "productId": "MLB178925", "itemId": "MLB3456789012", "title": "Smartphone Samsung Galaxy A55 5G 256GB", "url": "https://www.mercadolivre.com.br/p/MLB178925", "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_123456-MLB789.jpg", "seller": "Samsung Store Oficial", "isOfficialStore": true, "price": 1799.0, "originalPrice": 2499.0, "currency": "BRL", "discountPercentage": 28, "dealType": "OFERTA DO DIA", "installments": "ou 10x R$ 179,90 sem juros", "coupon": "Cupom 5% OFF", "rating": 4.8, "ratingCount": 3627, "shipping": "Frete grátis", "isFullShipping": true, "highlight": "MAIS VENDIDO", "isSponsored": false, "isInternational": false, "scrapedAt": "2026-06-26T12:00:00.000Z" } //... ] ``` ### Output fields | Field | Type | Description | | -------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `position` | `number` | 1-based position in the deals listing (across pages) | | `productId` | `string \| null` | Catalog/product-group ID (e.g. `MLB178925`). Groups all seller offers for the same product. `null` for listings not linked to a catalog entry. | | `itemId` | `string \| null` | Individual listing ID (e.g. `MLB3456789012`). Unique per seller offer — equivalent to the `wid` parameter in the card URL. | | `title` | `string` | Product title | | `url` | `string` | Product page URL | | `thumbnail` | `string \| null` | Product image URL | | `seller` | `string \| null` | Seller or official store name | | `isOfficialStore` | `boolean` | Whether the seller carries the "Loja oficial" (official store) badge | | `price` | `number \| null` | Current (discounted) price in BRL | | `originalPrice` | `number \| null` | Original price before the deal discount | | `currency` | `string` | Always `"BRL"` | | `discountPercentage` | `number \| null` | Discount percentage (e.g. `28`) | | `dealType` | `string \| null` | Deal badge, e.g. `"OFERTA DO DIA"` or `"OFERTA RELÂMPAGO"`. `null` when the card carries no deal label. | | `installments` | `string \| null` | Instalment text | | `coupon` | `string \| null` | Coupon badge on the card (e.g. `"Cupom 5% OFF"`). `null` when no coupon is offered. | | `rating` | `number \| null` | Average user rating (0–5) | | `ratingCount` | `number \| null` | Number of user ratings (e.g. `3627`). `null` when unavailable. | | `shipping` | `string \| null` | Shipping label (e.g. `"Frete grátis"`) | | `isFullShipping` | `boolean` | Whether the listing ships via MercadoLivre Full (fulfillment) | | `highlight` | `string \| null` | Badge text (e.g. `"MAIS VENDIDO"`) | | `isSponsored` | `boolean` | Whether the listing is a paid ad | | `isInternational` | `boolean` | Whether the product is sold by a cross-border (international) merchant, indicated by the CBT badge | | `scrapedAt` | `string` | ISO 8601 timestamp of when the record was scraped | ### How much does it cost to scrape MercadoLivre deals? This Actor uses Apify's **pay-per-event** pricing: you pay fixed prices for what the Actor does, and **you are not charged separately for Apify platform usage** (compute, bandwidth, or other infrastructure). There are just two charges: | Event | When it applies | | ------------ | ------------------------------------- | | **Per run** | Once each time a run starts | | **Per deal** | For each deal returned to the dataset | The **per-run** fee covers the fixed infrastructure every run relies on — premium residential IPs and the compute to reliably load and parse the deals page. The **per-deal** fee applies to each record pushed to the dataset. This means the exact cost of a run is predictable before you start it: it depends only on how many deals you ask for, not on how long the run takes or how much bandwidth it uses. A quick estimate at the current rates: | Deals (`maxItems`) | Approx. cost per run | | ------------------ | -------------------- | | 48 (1 page, default) | ~$0.18 | | 200 | ~$0.64 | | 1000 (max) | ~$3.04 | See the **Pricing** section on the Actor's page for the exact per-run and per-deal rates. Apify's [free plan](https://apify.com/pricing) also includes monthly free usage — enough to try the Actor without paying anything. #### Tips to keep costs low - Set `maxItems` to only what you need — you pay per deal returned. - Use the `category` filter to focus on the department you care about instead of paging through every deal. ### FAQ #### Is it legal to scrape MercadoLivre? This Actor only collects publicly available product/deal data — the same information visible to any visitor without logging in. No private user data is collected. Always comply with MercadoLivre's [Terms of Service](https://www.mercadolivre.com.br/ajuda/termos-e-politicas_194) and applicable local laws. Do not use scraped data in ways that compete unfairly with MercadoLivre or its sellers. #### Do I need an API key or MercadoLivre account? No. The Actor works without any MercadoLivre credentials. You only need a free Apify account to run it. #### Can I monitor deals on a schedule? Yes. Use Apify [Schedules](https://docs.apify.com/platform/schedules) to run the Actor automatically (e.g. every morning) and store each run's dataset, then compare results over time to build a deal/price history. #### Some fields come back as `null` — is that expected? Yes. Not every deal card includes all fields. For example, `rating` and `ratingCount` only appear when the product has reviews, `coupon` only when a coupon is offered, and `dealType` only when a deal badge is shown. Missing fields are set to `null` rather than omitted so the schema is always consistent. #### The scraper got bot-blocked — what can I do? Blocks are rare: every run uses premium residential IPs and automatic retries to keep success rates high. If a run still comes back empty or partial, simply run it again — transient blocks usually clear on a retry. ### Changelog #### 2026-06-26 - **Added** `isOfficialStore` — whether the seller carries the "Loja oficial" (official store) badge. - **Added** `coupon` — coupon badge text on the card (e.g. `"Cupom 5% OFF"`). - **Added** `ratingCount` — number of user ratings (e.g. `3627`). - **Removed** `soldCount` — MercadoLivre's current card layout no longer exposes a sold/review count. - **Removed** `soldPercentage` — MercadoLivre replaced the stock meter with a countdown timer, so the "% sold" value is no longer available. - **Fixed** `rating`, `discountPercentage`, `shipping`, `installments`, `dealType` and `isFullShipping`, which had stopped populating (or returned dirty values) after MercadoLivre changed its card markup. `dealType` now also captures "OFERTA DO DIA" (previously it leaked into `highlight`). ### Support If you encounter a bug or have a suggestion for this Actor or for a new one, please reach out via the **Issues** tab and we'll look into it ASAP. # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of deals to scrape from the MercadoLivre daily deals page (https://www.mercadolivre.com.br/ofertas). The page serves 48 deals per page, so the minimum (and default) is one full page of 48. Higher values paginate 48 at a time until this number is reached or the deals run out, up to a cap of 1000 (about 21 pages). ## `category` (type: `string`): Restrict the deals to a single MercadoLivre category. Choose "Todas as categorias" to scrape every deal regardless of category. ## Actor input object example ```json { "maxItems": 48, "category": "all" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("riseandcode/apify-mercadolivre-deals").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 = {} # Run the Actor and wait for it to finish run = client.actor("riseandcode/apify-mercadolivre-deals").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 '{}' | apify call riseandcode/apify-mercadolivre-deals --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=riseandcode/apify-mercadolivre-deals", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "MercadoLivre Deals Scraper", "description": "Scrape every deal from MercadoLivre's \"Ofertas do Dia\" page into structured JSON — title, current & original price, discount %, coupon, seller, official-store badge, rating, installments, and shipping (incl. Full). Run once or schedule it daily to track promotions automatically. No code required.", "version": "0.0", "x-build-id": "eYkY2sO9dcJ88QPyB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/riseandcode~apify-mercadolivre-deals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-riseandcode-apify-mercadolivre-deals", "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/riseandcode~apify-mercadolivre-deals/runs": { "post": { "operationId": "runs-sync-riseandcode-apify-mercadolivre-deals", "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/riseandcode~apify-mercadolivre-deals/run-sync": { "post": { "operationId": "run-sync-riseandcode-apify-mercadolivre-deals", "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": { "maxItems": { "title": "Max Items", "minimum": 48, "maximum": 1000, "type": "integer", "description": "Maximum number of deals to scrape from the MercadoLivre daily deals page (https://www.mercadolivre.com.br/ofertas). The page serves 48 deals per page, so the minimum (and default) is one full page of 48. Higher values paginate 48 at a time until this number is reached or the deals run out, up to a cap of 1000 (about 21 pages).", "default": 48 }, "category": { "title": "Category", "enum": [ "all", "MLB5672", "MLB1403", "MLB1367", "MLB1368", "MLB1384", "MLB1246", "MLB1132", "MLB1430", "MLB1574", "MLB1051", "MLB1500", "MLB1039", "MLB5726", "MLB1000", "MLB1276", "MLB263532", "MLB12404", "MLB1144", "MLB1499", "MLB1648", "MLB1182", "MLB3937", "MLB1196", "MLB1953", "MLB1071", "MLB264586" ], "type": "string", "description": "Restrict the deals to a single MercadoLivre category. Choose \"Todas as categorias\" to scrape every deal regardless of category.", "default": "all" } } }, "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 } } } } } } } } } } ```