{ "openapi": "3.0.1", "info": { "title": "Mercado Libre Inmuebles Scraper: Argentina, Mexico & Chile API", "description": "MercadoLibre Inmuebles scraper and real estate API for Argentina, Mexico & Chile (Portal Inmobiliario), at $0.40 per 1,000 listings. Paste any search URL or filter by region, city and property type; get one record per listing with price, currency, location, rooms, surface, photos and URL.", "version": "0.5", "x-build-id": "OMd0f4H4buwvNl3iT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automatic~ml-inmuebles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automatic-ml-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/automatic~ml-inmuebles-scraper/runs": { "post": { "operationId": "runs-sync-automatic-ml-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/automatic~ml-inmuebles-scraper/run-sync": { "post": { "operationId": "run-sync-automatic-ml-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": { "startUrls": { "title": "Search URLs (optional)", "type": "array", "description": "Paste one or more search pages from inmuebles.mercadolibre.com.ar, inmuebles.mercadolibre.com.mx or www.portalinmobiliario.com (Chile), with any filters you set in the browser (neighborhood, price range, rooms, surface, sort order). When given, these searches run instead of the country, type, operation, province and city fields below; Maximum pages and Maximum results apply to each URL. Leave empty to use the fields below.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "ar", "mx", "cl" ], "type": "string", "description": "Country site to search: Argentina (inmuebles.mercadolibre.com.ar, ARS prices), Mexico (inmuebles.mercadolibre.com.mx, MXN prices) or Chile (www.portalinmobiliario.com, MercadoLibre's Chilean property site: CLP prices, or CLF for prices in UF). USD-marked listings stay USD everywhere. Uruguay and Colombia are not supported yet.", "default": "ar" }, "propertyType": { "title": "Property type", "enum": [ "departamentos", "casas", "ph", "terrenos", "campos", "quintas", "oficinas", "locales", "galpones", "parcelas", "sitios", "bodegas", "industriales", "agricolas", "estacionamientos" ], "type": "string", "description": "Property type to search. 'ph', 'campos', 'quintas' and 'galpones' exist on Argentina/Mexico only ('ph' on Argentina only); 'parcelas', 'sitios', 'bodegas', 'industriales', 'agricolas' and 'estacionamientos' exist on Chile only. An unsupported type for the selected country fails fast.", "default": "departamentos" }, "operation": { "title": "Operation", "enum": [ "venta", "alquiler" ], "type": "string", "description": "Sale or rental search.", "default": "venta" }, "province": { "title": "Province / state", "type": "string", "description": "Optional province (AR), state (MX) or region (CL) slug to scope the search, e.g. 'capital-federal', 'distrito-federal', 'nuevo-leon', 'metropolitana', 'valparaiso'. Free text is slugified ('Capital Federal' -> 'capital-federal'). Chile takes one of its 16 region slugs (metropolitana, valparaiso, biobio, bernardo-ohiggins, ...); any other value fails fast. On Argentina and Mexico, a slug the site redirects to a broader search is reported in OUTPUT.failedSearches instead of returning the wider listings; MercadoLibre sometimes corrects a misspelling itself, so check the slug. Empty searches the whole country.", "default": "" }, "city": { "title": "City / neighborhood", "type": "string", "description": "Optional city to scope the search, e.g. 'palermo', 'polanco', or a Chilean comuna such as 'las-condes'. Requires a province. A slug the site redirects to a broader search is reported in OUTPUT.failedSearches instead.", "default": "" }, "maxPages": { "title": "Maximum pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "Search-result pages to fetch (about 48 listings per page on the ML grid).", "default": 1 }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Stop after this many listings.", "default": 50 }, "requestDelaySecs": { "title": "Delay between page requests", "minimum": 0.5, "maximum": 10, "type": "number", "description": "Minimum 0.5 seconds between fetches.", "default": 1 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. Defaults to the selected country when Apify Proxy is used." }, "apifyProxyGroups": { "title": "Apify proxy groups (advanced)", "type": "array", "description": "Optional platform proxy groups.", "items": { "type": "string" } }, "apifyProxyCountry": { "title": "Apify proxy country (advanced)", "type": "string", "description": "Optional two-letter country override. Defaults to the selected country." } } }, "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 } } } } } } } } } }