# Mercado Libre Scraper: Cars, Property & Category Alerts (`accountable_eel/mercadolibre-listing-lookup`) Actor Mercado Libre scraper for car, property and category pages in Mexico, Argentina, Colombia (TuCarro), Chile (Portal Inmobiliario), Uruguay and Brazil. Monitor new listings, price drops and gone ones: a Mercado Libre sold items tracker with sell-through rate and median price. No login. - **URL**: https://apify.com/accountable\_eel/mercadolibre-listing-lookup.md - **Developed by:** [Adrian Voss](https://apify.com/accountable_eel) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 listing returneds 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Mercado Libre Scraper: Cars, Property & Category Alerts Watch a search, get only what's new. This actor reads **Mercado Libre's car, property and category pages** in Mexico, Argentina, Colombia (TuCarro), Chile (Portal Inmobiliario), Uruguay and Brazil, and returns one clean row per listing: title, price and currency, year and kilometres for cars, rooms and area for property, official-store badge, location, image and a permanent link. Turn on monitoring and it becomes a watchlist: new listings and price drops since your last run, charged per new row, free on quiet days. Add the **sold signal** and it also works as a **Mercado Libre sold items tracker**: listings that left the page since the last run, which of them were presumably sold, and the page's **sell-through rate** and median price. Schedule it and send the results to WhatsApp, Discord, Google Sheets or n8n. **Mercado Libre blocks automated keyword search; this actor monitors category and vertical pages.** Keyword-search links (`lista.mercadolivre.com.br/...`, `listado.mercadolibre.com.mx/...`) and item pages go to Mercado Libre's own bot check, which also stopped a residential and an unblocking proxy in our tests. Car, property and category pages load normally, and that is what this actor watches. ### Who it's for A used-car buyer in Mexico City who wants every new Nissan listing the day it's posted. A dealer in Buenos Aires tracking Toyota prices. A renter in Santiago watching new apartments in Providencia on Portal Inmobiliario. A reseller in São Paulo watching which phones Mercado Livre is putting on offer. Each of them gets a live feed of what was just posted, without refreshing the page by hand. The Mercado Libre actors already on the Apify Store export a one-off list; none of them offers monitoring, and TuCarro and Portal Inmobiliario have almost no Store coverage at all. ### Why this one - **Monitoring first, not a one-off dump.** Turn on "Only return results that are new, or dropped in price" and each page becomes a watchlist. The actor remembers every Mercado Libre item ID it has shown you and bills only for what is new or cheaper since the last run. A quiet run costs only the run fee. - **Sold signal and sell-through rate.** Tick "Alert on gone listings" and a watchlist also reports the listings that disappeared from the page, with their last price, days listed and a `gonePresumedSold` flag, plus a lifetime sell-through rate. See "Sold signal and sell-through" below. - **Uses Mercado Libre's own "Publicados hoy" filter.** Car pages have no newest-first sort, so a monitor would otherwise re-read the "most relevant" listings every run. With monitoring on, the actor follows the page's own "Publicados hoy" (published today) link, so each run reads today's new listings. - **Six countries, three verticals, one input shape.** Paste any car, property or category page URL with the filters you set on the site, or type a make like `nissan` and pick a country. - **Typed columns from the page's own data**, not text scraped off the layout: the item ID (`MLM...`, `MLA...`, `MCO...`, `MLC...`, `MLU...`, `MLB...`), the price and its currency code (including UF on Portal Inmobiliario), year and kilometres, rooms, bathrooms and m². - **Never charged for a miss or a quiet monitoring run.** A page that is blocked or empty gets a free row that says why. ### What you get One row per listing by default (turn off "Expand rows" in Advanced to get one row per search instead, with the listings nested under `listings`). | query | found | status | searchQuery | searchUrl | country | pageType | publishedTodayOnly | sortApplied | viaResidentialProxy | listingCount | totalAvailable | truncated | newCount | priceDropCount | goneCount | sellThroughRate | medianPrice | medianPriceCurrency | monitorStatus | listings | listingId | title | price | currency | isPriceFrom | vertical | listingType | isOfficialStore | officialStoreName | year | km | rooms | bathrooms | areaM2 | attributes | location | imageUrl | changeType | isNew | previousPrice | priceDropPct | firstSeenAt | lastSeenAt | daysListed | url | scrapedAt | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | https://www.mercadolivre.com.br/c/celulares-e-telefones | true | OK | https://www.mercadolivre.com.br/c/celulares-e-telefones | https://www.mercadolivre.com.br/c/celulares-e-telefones | br | category-deals | false | relevance | false | 20 | 20 | false | | | \ | \ | \ | | | \ | MLB6001548604 | Smartphone Huawei Pura 80 Pro 12gb+512gb Câmera Ultra-iluminação De 1 Polegada Câmera Teleobjetiva Macro Ultra-iluminação Cancelamento De Ruído Por Ia 5.17 Ah Dual Supercharge Celular Preto | 3999 | BRL | false | category-deals | | false | | | | | | | | | https://http2.mlstatic.com/D\_Q\_NP\_2X\_673005-MLA113775487924\_072026-AB.webp | | | | | | | \ | https://www.mercadolivre.com.br/smartphone-huawei-pura-80-pro-12gb512gb-camera-ultra-iluminacao-de-1-polegada-camera-teleobjetiva-macro-ultra-iluminacao-cancelamento-de-ruido-por-ia-517-ah-dual-supercharge-celular-preto/p/MLB58089730?pdp\_filters=deal%3AMLB1536253-2 | 2026-09-24T06:20:13.130Z | | Field | Type | Description | |---|---|---| | `query` | text | Your input line, echoed back | | `found` | boolean | `true` if Mercado Libre returned a page with listings for this line | | `status` | text | `OK` on a match; `NOT_FOUND`, `BLOCKED` or `BAD_FORMAT` on a miss | | `message` | text | Plain-English reason for a miss, only present when `found` is `false` | | `searchQuery` | text | Your input line | | `searchUrl` | link | The Mercado Libre page actually read (after sort and "Publicados hoy") | | `country` | text | `mx`, `ar`, `co`, `cl`, `uy` or `br` | | `pageType` | text | `search` for car, property and category search pages; `category-deals` for a Brazil `/c/` landing page | | `publishedTodayOnly` | boolean | `true` when the "Publicados hoy" filter was applied | | `sortApplied` | text | The sort actually used, or empty when the page did not offer the one you chose | | `listingCount` | number | Listings returned and billed for this line | | `totalAvailable` | number | Total listings Mercado Libre reports for this page | | `truncated` | boolean | `true` if more results existed than were returned | | `newCount` / `priceDropCount` | number | New listings and price drops this run (monitoring only) | | `goneCount` | number | Listings that left the page since the last run, whether or not "Alert on gone listings" returns them. Empty when this run could not check (first run, or the page was not read in full) | | `sellThroughRate` | number | Lifetime share of this watchlist's listings that went gone, 0 to 1 (0.25 = one in four). Empty until the watchlist has made its first gone check (monitoring only) | | `medianPrice` / `medianPriceCurrency` | number / text | Median price of every listing this run read, in the page's most common currency (monitoring only) | | `monitorStatus` | text | `NO_NEW_ROWS` on a quiet monitoring run, `WATCHLIST_SEEDED` on a silent first run | | `listingId` | text | Mercado Libre's item ID, e.g. `MLM5496379898` | | `title` | text | Listing title | | `price` | number | Price as shown on the card | | `currency` | text | `MXN`, `ARS`, `COP`, `CLP`, `CLF` (UF), `UYU`, `USD` or `BRL` | | `isPriceFrom` | boolean | `true` when the card says "Desde" (a new-car range or a development's lowest unit) | | `vertical` | text | `cars`, `property`, `category` or `category-deals` | | `listingType` | text | Mercado Libre's own listing domain, e.g. `CARS_AND_VANS`, `APARTMENTS_FOR_RENT` | | `isOfficialStore` | boolean | Sold by a Mercado Libre official store (a brand or dealership) | | `officialStoreName` | text | That official store's name, e.g. "Nissan". Empty for every other seller | | `year` / `km` | number | Cars only | | `rooms` / `bathrooms` / `areaM2` | number | Property only. For a development listed as a range ("1 a 3 dormitorios") the lower bound | | `attributes` | text | The card's attribute strip as shown, e.g. "2020 | 60.000 Km" | | `location` | text | Location as shown on the card, where the card has one | | `imageUrl` | link | First listing image | | `changeType` | text | `new`, `price-drop`, `gone` or `seen` (monitoring only) | | `isNew` | boolean | `true` on this listing's first appearance (monitoring only) | | `previousPrice` / `priceDropPct` | number | The last recorded price and the drop, on a price drop (monitoring only) | | `firstSeenAt` | date | When this watchlist first saw the listing (monitoring only) | | `lastSeenAt` / `daysListed` | date / number | When the listing was last seen, and the days between first and last sighting (monitoring only) | | `lastPrice` | number | Gone rows only: the last price seen before the listing left the page | | `gonePresumedSold` | boolean | Gone rows only: seen on 2+ runs in a row and priced at or under the page's median in its currency | | `url` | link | Permanent listing link | | `scrapedAt` | date | When this row was fetched | ### Pricing - **Listing returned**: $2 per 1,000 listings Plus a $0.00005 start fee per run. Each event above is billed independently, only when it actually returns data — misses (`found:false`) are never charged. ### Monitoring / only new results Turn on **"Only return results that are new, or dropped in price"** and a line becomes a watchlist: - A listing counts as **new** the first time its Mercado Libre item ID is returned by this watchlist. - A listing counts as a **price drop** when its price falls by at least "Minimum price drop" (5% by default) since it was last seen, measured against the most recently seen price. - Already-seen, unchanged listings are dropped before you're billed. A quiet run returns one free row with `monitorStatus: NO_NEW_ROWS`. - The **first run has nothing to compare against**, so it returns everything as new. Turn on **"Seed silently"** to bank the first run quietly and start alerting from the second run. - With monitoring on, **"Published today filter" = Auto** reads the page's "Publicados hoy" view. Mercado Libre's "today" ends at midnight in the country's time zone, so schedule the watchlist every few hours (for example 09:00, 15:00 and 21:00 local time) to catch listings published late in the day. Set it to "Never" to watch the page in its normal order instead (best with the "Newest first" sort on Portal Inmobiliario, the one site that offers it). **Monitoring with Auto "Publicados hoy" makes no gone check**, because yesterday's listings leave the "today" view at midnight whether they sold or not. Ticking "Alert on gone listings" switches Auto to the whole page (see below). **Schedule recipe.** Save this actor as an Apify **Task** with `deltaMode: true` and a `deltaName` you choose, add a **Schedule** every few hours, and point the task's **webhook** at Discord, Slack, Google Sheets, or an n8n/Make webhook URL. **Price-drop window limitation.** A price drop is only seen while the listing is still inside what a run reads. With "Publicados hoy" on, that is today's listings, so price drops on older listings are only caught with the filter set to "Never" and a narrow page (a model, a city, a price band). ### Sold signal and sell-through Tick **"Alert on gone listings"** and a watchlist tells you which listings left the page since the last run. This makes the actor a **Mercado Libre sold items tracker** for a car model, a neighbourhood's rentals or a category: how fast listings move, at what price, and what share of them sells. **What "gone" means, honestly.** Mercado Libre never shows that a listing sold. `gone` means **delisted: most often sold, sometimes withdrawn**. A seller may also pause a listing, delete it and repost it under a new ID, or edit it so it no longer matches the page's filters (a price outside a price filter you set in this actor is checked and is *not* called gone). `gonePresumedSold: true` is our stronger guess: the listing was seen on 2 or more runs in a row **and** its last price was at or under the page's median price in the same currency. A cheap listing that stayed up and then vanished most likely sold; an overpriced one may just have been withdrawn. **How detection works, and its limit.** Mercado Libre sorts car and property pages by relevance (car pages have no newest-first sort), so a listing's position on the page can't tell "sold" apart from "pushed further down". The actor therefore only checks for gone listings when a run **read the whole page**: it followed the page's own next-page links to the last page, the number of listings read matches Mercado Libre's own total, nothing was blocked or failed, and nothing was cut by "Most listings to return". Then every remembered listing that is missing is gone. If any of that is not true, the run makes **no gone check** and `goneCount` is empty; nothing is ever declared gone on a first run, an empty page or a blocked run. So: - **Watch a page that fits in one run.** Filter on the site (a model and year, a city, a price band) until the page has fewer listings than your "Most listings to return" (max 1,000), then paste that URL. A 4,744-listing "nissan" page is never read in full, so it never reports gone listings. - With "Alert on gone listings" on, **"Published today filter" = Auto reads the whole page** instead of "Publicados hoy". "Always" keeps the today view, and then no gone check is possible. - Brazil's `/c/` featured-offers pages rotate their products, so they make no gone check either. - A gone listing is reported **once**. If it comes back (a paused listing reactivated), it is not re-alerted and it is taken back off the sell-through count. A listing not seen for 30 days is forgotten without being reported. - **Sell-through rate** = listings that went gone / listings this watchlist ever tracked, over its lifetime. Gone listings are **counted even when "Alert on gone listings" is off**, so the rate is right from the first run that reads the page in full. It stays empty until that first check. **Billing.** Gone rows are ordinary listing rows, billed like any other listing (no separate event), and only returned when "Alert on gone listings" is on. A gone row never loads the listing again: it is rebuilt from what the watchlist saw last time (title, link, last price, year and km, rooms and area, location), so image and attribute strip are empty on it. **Example input** (daily watchlist of apartments for rent in Providencia, Santiago, about 730 listings on Portal Inmobiliario, so one run reads the whole page; for a rental, "gone" most often means rented): ```json { "searches": ["https://www.portalinmobiliario.com/arriendo/departamento/providencia-metropolitana"], "maxListingsPerSearch": 1000, "deltaMode": true, "deltaName": "providencia-rent-sold", "skipFirstRun": true, "alertOnGone": true, "alertOnNew": false, "alertOnPriceDrop": false } ``` The first run banks the page silently. Every later run returns only the gone rows, each with `gonePresumedSold`, `lastPrice` and `daysListed`, and `sellThroughRate` on every row. An unnamed watchlist gets a fresh memory automatically when you tick "Alert on gone listings" with Auto; a **named** one keeps its memory, which came from the "today" view, so the first whole-page run would report the page's older listings as new. Use a new `deltaName` (or "Seed silently" on a new name) when you add the sold signal to an existing watchlist. ### How to use 1. **In the Apify Console.** Open the actor page and click **Start** — the `searches` field is already pre-filled with a working example. Results land in the run's dataset as soon as each item is found. 2. **Via the API.** Call it directly with a POST request — no Console needed once you have an API token: ```bash curl "https://api.apify.com/v2/acts/accountable_eel~mercadolibre-listing-lookup/run-sync-get-dataset-items?token=" \ -X POST \ -H "Content-Type: application/json" \ -d '{"searches":["https://autos.mercadolibre.com.mx/nissan"]}' ``` 3. **On a schedule.** Save this actor as an Apify **Task** with the input you want, then add a **Schedule** (hourly, daily, weekly) so it runs on its own — no server of your own required. 4) **Which pages work.** Paste the page from your browser, filters included: | Country | Cars | Property | Category pages | |---|---|---|---| | Mexico | `autos.mercadolibre.com.mx/` (a make works as a path keyword) | `inmuebles.mercadolibre.com.mx/...` (not tested at build time) | `www.mercadolibre.com.mx/c/` (not tested at build time) | | Argentina | `autos.mercadolibre.com.ar/` (a make works as a path keyword) | `inmuebles.mercadolibre.com.ar/...` (not tested at build time) | not tested | | Colombia | TuCarro, `carros.tucarro.com.co/` (paste a filtered URL) | `inmuebles.mercadolibre.com.co/...` (not tested at build time) | not tested | | Chile | `autos.mercadolibre.cl/` (paste a filtered URL) | Portal Inmobiliario, `www.portalinmobiliario.com///-metropolitana` | not tested | | Uruguay | `autos.mercadolibre.com.uy/` (paste a filtered URL) | `inmuebles.mercadolibre.com.uy/...` (not tested at build time) | not tested | | Brazil | blocked by Mercado Livre's bot check | blocked by Mercado Livre's bot check | `www.mercadolivre.com.br/c/` (featured offers, about 20 per page) | On Colombia, Chile and Uruguay a make typed as a plain line is read as a narrow text match (one to four results in our tests), so filter by make on the site and paste that URL instead. Peru and Ecuador car pages go to the bot check and are not supported. ### Input ```json { "searches": [ "https://autos.mercadolibre.com.mx/nissan" ] } ``` One per line. Paste a car, property or category page URL from Mercado Libre, TuCarro or Portal Inmobiliario (filters included), or type a make like "nissan" and pick the country and meaning below. Keyword-search links (lista. / listado.) are not supported: Mercado Libre blocks automated keyword search. Accepted formats: https://autos.mercadolibre.com.mx/nissan, https://www.portalinmobiliario.com/arriendo/departamento/providencia-metropolitana, https://www.mercadolivre.com.br/c/celulares-e-telefones, toyota. ### Sample output See the table under "What you get" above. A line that finds nothing comes back as a row with `"found": false` and is never charged. A quiet monitoring run comes back as a row with `"found": true, "monitorStatus": "NO_NEW_ROWS"` and is also never charged. ### Use it from Clay, n8n, Make, or an AI agent This actor runs synchronously over plain HTTP — call it directly from a script, a workflow tool, or an AI agent, no Apify Console needed once you have an API token. ```bash curl "https://api.apify.com/v2/acts/accountable_eel~mercadolibre-listing-lookup/run-sync-get-dataset-items?token=" \ -X POST \ -H "Content-Type: application/json" \ -d '{"searches":["https://autos.mercadolibre.com.mx/nissan"]}' ``` **n8n.** Add an HTTP Request node: Method `POST`, URL `https://api.apify.com/v2/acts/accountable_eel~mercadolibre-listing-lookup/run-sync-get-dataset-items?token=`, Body Content Type `JSON`, JSON Body `{"searches":["https://autos.mercadolibre.com.mx/nissan"]}` (swap in an expression from an earlier node for a real value). **Clay.** Add an "HTTP API" column: Method `POST`, URL `https://api.apify.com/v2/acts/accountable_eel~mercadolibre-listing-lookup/run-sync-get-dataset-items?token=`, Body `{"searches":["{{search}}"]}`, mapping the row's search into the `searches` array. **MCP.** In Claude, Cursor, or any MCP client with the Apify MCP server, ask for "Mercado Libre Scraper: Car & Property Alerts" — the agent will find and run this actor. For monitoring, point the Task's webhook (Console, your Task, Webhooks) at a Discord or Slack incoming-webhook URL, a WhatsApp automation, or an n8n/Make workflow's webhook trigger. ### Tips - For a sold-signal watchlist, turn on "Seed silently" and leave "Alert on new listings" off: the first run banks the page and every later run returns only what left it. - Turn on "Seed silently" for a watchlist you're putting on a schedule, so day one isn't a wall of "new" alerts. - Portal Inmobiliario lists some rentals in UF (`CLF`) and others in pesos (`CLP`) on the same page. The minimum and maximum price filters compare numbers in each listing's own currency, so filter on `currency` too, or set the currency on the site before you paste the URL. - Brazil's `/c/` pages show Mercado Livre's featured offers for a category (around 20 products), not every listing. Monitoring one reports new offers and price drops among them. - A `BLOCKED` status with "account verification" in the message means that page type is behind Mercado Libre's bot check. Use a car, property or category page from the table above instead. ### vs. the other Mercado Libre actors The largest Mercado Libre actors on the Apify Store (karamelo: 174 users in 30 days on Brazil and 167 on the Spanish-language sites; Apify's generic e-commerce scraper: 631) export a one-off list of products. None of them offers new-listing or price-drop monitoring, and TuCarro and Portal Inmobiliario have almost no dedicated coverage. | | What it costs | What you get | Trade-off | |---|---|---|---| | **This actor** | Pay per listing returned; nothing for a miss or a quiet monitoring run | Car, property and category pages in 6 countries, monitoring (new + price drop + gone / presumed sold), sell-through rate, "Publicados hoy", year/km, rooms/area | No keyword search: Mercado Libre blocks it for automated visitors | | One-off Mercado Libre product scrapers | Varies | Product lists, often by keyword | No watchlist; you diff the exports yourself | | Doing it yourself | Your time | The same data | This actor's page-state parsing, link-following and monitoring memory are the upkeep it absorbs | ### Data & privacy This actor reads public listing pages that anyone can see without logging in. It doesn't log in, solve CAPTCHAs, or reveal hidden contact details, and it doesn't use Mercado Libre's API. Listing cards carry no private seller identity: the only seller detail output is the name of an official store (a brand or dealership) when Mercado Libre shows that badge. Seller phone numbers and emails are never collected. Not affiliated with Mercado Libre. **Is this allowed?** It collects the same public listing data your browser shows, for the pages you choose. It's built for monitoring a page, not for copying the marketplace. Check that your use fits Mercado Libre's terms and your local law (Brazil's LGPD, for example, is close to the GDPR). ### FAQ **Why can't I search by keyword?** Mercado Libre sends automated keyword searches and item pages to an "account verification" bot check. In our tests it stopped a Brazilian residential IP and an unblocking proxy too. Car, property and category pages are not behind it, so the actor watches those. **Why is a row empty, or why does `found` say `false`?** The line was blank or not a Mercado Libre link (`BAD_FORMAT`), the page went to the bot check (`BLOCKED`), or the page had no listings right now (`NOT_FOUND`). The `message` column says which. None of these are billed. **Does it find sold listings?** It finds listings that left the page, which is the closest a public Mercado Libre page gets: the site never marks a listing as sold. Turn on "Alert on gone listings". Each gone row says whether it is presumed sold (seen on 2+ runs and priced at or under the median) and the watchlist gets a sell-through rate. It only works on pages the actor can read in full in one run; see "Sold signal and sell-through". **Am I charged for a quiet monitoring run?** No. When nothing is new and nothing is cheaper you get one row with `monitorStatus: NO_NEW_ROWS` and `listingCount: 0`, and billing only fires when `listingCount` is above zero. **Why does a car price say "from" (`isPriceFrom: true`)?** New cars sold by official stores and new property developments show a "Desde" (from) price for the cheapest version or unit. The card's number is kept as is and flagged. **Do I need to configure proxies?** No. The actor starts on Apify's default datacenter proxy. Some pages (the Mexico car pages, for example) send data-centre visitors to Mercado Libre's bot check; those are fetched again through a residential IP in the page's own country, automatically, and the row says so in `viaResidentialProxy`. You can turn that off in the input. No proxy helps with keyword search. **Can an AI agent call this directly?** Yes. An agent in Claude, Cursor or another MCP client with the Apify MCP server can find and run it by name, or you can call the REST endpoint shown above. ### Related actors - [OLX Pakistan Scraper](https://apify.com/accountable_eel/olx-pakistan-listing-lookup): the same watch-a-search monitoring for Pakistan's largest classifieds site. - [OLX Scraper](https://apify.com/accountable_eel/olx-listing-lookup): multi-country OLX listings with the same monitoring mode. # Actor input Schema ## `searches` (type: `array`): One per line. Paste a car, property or category page URL from Mercado Libre, TuCarro or Portal Inmobiliario (filters included), or type a make like "nissan" and pick the country and meaning below. Keyword-search links (lista. / listado.) are not supported: Mercado Libre blocks automated keyword search. Accepted formats: https://autos.mercadolibre.com.mx/nissan, https://www.portalinmobiliario.com/arriendo/departamento/providencia-metropolitana, https://www.mercadolivre.com.br/c/celulares-e-telefones, toyota. You're only charged for the ones we actually find — a miss costs nothing. ## `testRun` (type: `boolean`): Turn this on to test your input on a small sample before running the full list. Turn it off to process everything. ## `onlyFound` (type: `boolean`): Only keep rows where something was actually found. Misses are always free, whether or not you show them here. ## `includeKeywords` (type: `array`): Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything. ## `excludeKeywords` (type: `array`): Optional. Drop any result that mentions one of these words. Leave empty to skip nothing. ## `maxResults` (type: `integer`): Optional. Stop the run once this many results have been found — useful for a quick, cheap sample. Leave blank for no limit. ## `country` (type: `string`): Used for lines that are not links. A pasted Mercado Libre URL always uses its own country. Brazil supports category pages only: Mercado Livre's Brazil car and property pages sit behind its bot check. ## `vertical` (type: `string`): Used for lines that are not links. Cars turns "nissan" into https://autos.mercadolibre.com.mx/nissan (TuCarro in Colombia). Property turns a path into a Portal Inmobiliario (Chile) or inmuebles.mercadolibre page. Category turns a slug into https://www.mercadolivre.com.br/c/. Pasting the exact page URL from your browser, filters included, is always the most precise option. ## `maxListingsPerSearch` (type: `integer`): Mercado Libre shows 48 listings per page; this actor follows the site's own next-page link until it reaches your limit (max 1000). You pay per listing returned, so this is also your budget control. ## `sort` (type: `string`): Applied by following the page's own sort link. Car pages offer price sorts only; if a page doesn't offer the sort you chose, the default order is kept and the log says so. ## `publishedToday` (type: `string`): Mercado Libre has no reliable newest-first sort on car pages, but it does have a "Publicados hoy" filter. With monitoring on, Auto applies it so each run reads today's new listings instead of the most relevant ones. Schedule every few hours so listings published late in the day are caught before midnight (Mercado Libre's day, in the country's time zone). With "Alert on gone listings" on, Auto reads the whole page instead: a listing leaves the "today" view at midnight whether or not it sold, so the sold signal needs the full page. ## `residentialFallback` (type: `boolean`): On by default. Mercado Libre sends some pages (for example the Mexico car pages) to an "account verification" check when they are requested from a data-centre IP. With this on, those pages are fetched again through Apify's residential proxy in the page's own country, which is slower and costs a little more per page (still well inside the listing price). Turn it off to never use residential; affected pages then come back as BLOCKED rows, free. ## `minPrice` (type: `integer`): Optional, in the listing's own currency. Applied client-side. Portal Inmobiliario mixes UF (CLF) and peso (CLP) prices in one search, so check the currency column when you set this. ## `maxPrice` (type: `integer`): Optional, in the listing's own currency. Applied client-side. Leave empty for no maximum. ## `deltaMode` (type: `boolean`): Turns this actor into a monitor. A listing counts as new when its Mercado Libre item ID has not been returned by a previous run of the same watchlist, and as a price drop when its price falls since it was last seen (see "Minimum price drop" below). Already-seen, unchanged listings are dropped before you are billed, so a quiet run costs only the run fee. With monitoring on, the actor also applies Mercado Libre's own "Publicados hoy" (published today) filter where the page offers it; see "Published today filter" below. Tick "Alert on gone listings" to also get the listings that disappeared from the page (delisted, most often sold) and a sell-through rate. The first run has nothing to compare against, so (unless "Seed silently" is on) it returns everything and remembers it. ## `deltaName` (type: `string`): Leave empty and we derive one from this run's search settings, so two schedules with different settings keep separate memories. Type your own name to keep one memory across a settings change, or to have two schedules share one. ## `alertOnNew` (type: `boolean`): On by default. Turn off to have this watchlist report price drops only, not brand-new listings. ## `alertOnPriceDrop` (type: `boolean`): On by default. Turn off to have this watchlist report new listings only, ignoring price changes on ones you've already seen. ## `alertOnGone` (type: `boolean`): Off by default. When on, a listing this watchlist saw before and that is no longer on the page comes back as a row with changeType "gone", its last price, first and last sighting and days listed. gonePresumedSold is true when it was seen on 2+ runs in a row and priced at or under the page's median. Gone means delisted: most often sold, sometimes withdrawn or paused. Mercado Libre pages are sorted by relevance, so a listing is only called gone when the whole page was read in one run (pick a page narrow enough to fit under "Most listings to return", max 1000). Gone rows are ordinary listing rows, billed like any other; gone listings are counted for the sell-through rate even when this is off. ## `minPriceDropPct` (type: `integer`): A listing must drop by at least this percentage since it was last seen to be reported as a price-drop. ## `skipFirstRun` (type: `boolean`): Instead of returning every current listing as "new" the first time a watchlist runs, this banks them silently and starts alerting from the second run on. Stops a fresh watchlist from spamming a hundred messages to your webhook on day one. ## `columns` (type: `array`): Choose which pieces of information to include in each result row. All are included by default. ## `expandRows` (type: `boolean`): When on, each listing found gets its own row instead of being grouped under its search. You're still only charged once per search, no matter how many rows it produces. ## `maxConcurrency` (type: `integer`): Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady. ## `proxyConfiguration` (type: `object`): Apify Proxy config. Residential recommended for anti-bot-sensitive targets. ## Actor input object example ```json { "searches": [ "https://autos.mercadolibre.com.mx/nissan" ], "testRun": false, "onlyFound": false, "includeKeywords": [], "excludeKeywords": [], "country": "mx", "vertical": "cars", "maxListingsPerSearch": 100, "sort": "relevance", "publishedToday": "auto", "residentialFallback": true, "deltaMode": false, "deltaName": "", "alertOnNew": true, "alertOnPriceDrop": true, "alertOnGone": false, "minPriceDropPct": 5, "skipFirstRun": false, "columns": [ "searchQuery", "searchUrl", "country", "pageType", "publishedTodayOnly", "sortApplied", "viaResidentialProxy", "listingCount", "totalAvailable", "truncated", "newCount", "priceDropCount", "goneCount", "sellThroughRate", "medianPrice", "medianPriceCurrency", "monitorStatus", "listings", "listingId", "title", "price", "currency", "isPriceFrom", "vertical", "listingType", "isOfficialStore", "officialStoreName", "year", "km", "rooms", "bathrooms", "areaM2", "attributes", "location", "imageUrl", "changeType", "isNew", "previousPrice", "priceDropPct", "firstSeenAt", "lastSeenAt", "daysListed", "url" ], "expandRows": true, "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "searches": [ "https://autos.mercadolibre.com.mx/nissan" ], "includeKeywords": [], "excludeKeywords": [] }; // Run the Actor and wait for it to finish const run = await client.actor("accountable_eel/mercadolibre-listing-lookup").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 = { "searches": ["https://autos.mercadolibre.com.mx/nissan"], "includeKeywords": [], "excludeKeywords": [], } # Run the Actor and wait for it to finish run = client.actor("accountable_eel/mercadolibre-listing-lookup").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searches": [ "https://autos.mercadolibre.com.mx/nissan" ], "includeKeywords": [], "excludeKeywords": [] }' | apify call accountable_eel/mercadolibre-listing-lookup --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,accountable_eel/mercadolibre-listing-lookup" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/o9zyiFwDqvrwOapat/builds/0SyFL0SPGiXMwfpgz/openapi.json