{ "openapi": "3.0.1", "info": { "title": "Mercado Libre Inmuebles Scraper — Argentina & Mexico", "description": "Scrape property listings from Mercado Libre Inmuebles in Argentina and Mexico: price in ARS/MXN/USD with USD conversion, rooms, m², address, photos, GPS and seller type. Filter by operation, type, location, price, bedrooms. From US$2.50 per 1,000 properties.", "version": "0.1", "x-build-id": "VmGIhB6fEOnco2q5M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabrikit~mercadolibre-inmuebles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabrikit-mercadolibre-inmuebles-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/fabrikit~mercadolibre-inmuebles-scraper/runs": { "post": { "operationId": "runs-sync-fabrikit-mercadolibre-inmuebles-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/fabrikit~mercadolibre-inmuebles-scraper/run-sync": { "post": { "operationId": "run-sync-fabrikit-mercadolibre-inmuebles-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": { "country": { "title": "Country", "enum": [ "AR", "MX" ], "type": "string", "description": "Which Mercado Libre property portal to search: Argentina (inmuebles.mercadolibre.com.ar) or Mexico (inmuebles.mercadolibre.com.mx).", "default": "AR" }, "operation": { "title": "Operation", "enum": [ "sale", "rent", "temporary_rent" ], "type": "string", "description": "`sale` = venta, `rent` = alquiler (AR) / renta (MX), `temporary_rent` = alquiler temporario (AR) / renta vacacional (MX).", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "apartment", "house", "ph", "land", "commercial", "office", "parking", "warehouse", "farm", "country_house", "building", "room", "business", "other", "any" ], "type": "string", "description": "Property category. A few types exist in only one country (PH, parking, country house and business in Argentina; building and room in Mexico) — the run fails with a clear message if you pick one the selected country doesn't have.", "default": "apartment" }, "location": { "title": "Location", "type": "string", "description": "Free text: a state/province (`Capital Federal`, `Córdoba`, `Jalisco`, `CDMX`), a city (`Rosario`, `Zapopan`, `Monterrey`) or a neighbourhood (`Palermo`). If the site doesn't recognise a neighbourhood on its own, write it from most to least specific, separated by commas: `Nordelta, Tigre` or `Polanco, Miguel Hidalgo, CDMX`. You can also paste the site's own path (`capital-federal/palermo`). Leave empty to search the whole country. If the location can't be matched, the run fails with a clear error instead of returning nationwide or keyword results.", "default": "Capital Federal" }, "maxItems": { "title": "Max properties", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many properties. The site serves 48 listings per page and caps any single search at 2,016 results (42 pages) — narrow the filters (neighbourhood, price band, bedrooms) or add several direct URLs to cover a large market.", "default": 50 }, "fetchDetails": { "title": "Fetch detail pages (add-on)", "type": "boolean", "description": "Visit each listing's own page (1 extra request per property) to add GPS coordinates, publication date, seller type (agency vs. owner), condition, parking, exact rooms/bedrooms/bathrooms, monthly expenses (expensas / mantenimiento), the full spec table, the description and the full photo gallery. Each detail page is charged as a \"property details\" event on top of the listing event. Off = faster, cheaper runs with search-card data only.", "default": false }, "listingType": { "title": "Listing type", "enum": [ "all", "individual", "projects" ], "type": "string", "description": "`individual` = resale / rental units (propiedades individuales); `projects` = new developments sold off-plan (emprendimientos / desarrollos), whose price is a \"from\" price and whose rooms and surface are min–max ranges. With `all`, relevance sorting often lists projects first.", "default": "all" }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Minimum price in the selected price currency. 0 = no minimum.", "default": 0 }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Maximum price in the selected price currency. 0 = no maximum.", "default": 0 }, "priceCurrency": { "title": "Price filter currency", "enum": [ "local", "USD" ], "type": "string", "description": "Currency of the price filter: the local currency (ARS in Argentina, MXN in Mexico) or US dollars. Argentine sales are mostly listed in USD and rentals in ARS; the site converts, so a USD band also matches peso-priced listings. This only affects the filter — each result reports its own listed currency plus a `priceUsd` conversion.", "default": "local" }, "bedrooms": { "title": "Bedrooms", "enum": [ "any", "studio", "1", "2", "3", "4+" ], "type": "string", "description": "Exact number of bedrooms (dormitorios / recámaras). `studio` = monoambiente (0 bedrooms), `4+` = four or more.", "default": "any" }, "sort": { "title": "Sort order", "enum": [ "relevance", "price_asc", "price_desc", "newest", "oldest" ], "type": "string", "description": "`newest` (default) returns the most recently published listings first — the right choice for monitoring and for a representative sample of the market. `relevance` is the site's own order, which in big cities puts new-development projects first.", "default": "newest" }, "startUrls": { "title": "Direct search URLs (optional)", "type": "array", "description": "Instead of the filters above, paste one or more search-results URLs copied from inmuebles.mercadolibre.com.ar or inmuebles.mercadolibre.com.mx after applying any filters you like on the site (amenities, surface, age, keyword...). When this list is not empty, the filter fields above are ignored. Max properties applies to all URLs together.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. By default the Actor connects directly and, if Mercado Libre answers with its anti-bot verification page (it does for datacenter IPs, including Apify's), switches automatically to Apify RESIDENTIAL proxies in the searched country (AR or MX). You don't need to change this.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }