{ "openapi": "3.0.1", "info": { "title": "MercadoLibre Property Scraper - LatAm Real Estate Listings", "description": "Property listings from MercadoLibre in Venezuela, Uruguay, Paraguay and Guatemala. Asking price in the currency the seller quoted, dormitorios, baรฑos, mยฒ cubiertos, property type, venta or alquiler, departamento and ciudad, photos and a direct link. No code.", "version": "1.0", "x-build-id": "rdParrtI7VOwpgIau" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~mercadolibre-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-mercadolibre-property-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/sian.agency~mercadolibre-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-mercadolibre-property-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/sian.agency~mercadolibre-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-mercadolibre-property-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": { "operation": { "title": "๐ŸŽฏ What to do", "enum": [ "search", "detail" ], "type": "string", "description": "๐ŸŽฏ **PICK ONE PER RUN.**\n\n๐Ÿ” **Property Search** walks MercadoLibre's own place index and brings back 48 listings per request, each already carrying price, currency, dormitorios, baรฑos, area and place.\n\n๐Ÿ“„ **Property Detail** takes listing addresses you already have and opens each one for the full seller description, the whole attribute table and every photo.\n\n๐Ÿ’ก **TIP:** start with Property Search. The fields below that do not apply to the operation you pick are ignored.", "default": "search" }, "market": { "title": "๐ŸŒŽ MercadoLibre market", "enum": [ "ve", "uy", "py", "gt" ], "type": "string", "description": "๐ŸŒŽ **ONE MARKET PER RUN.** Each MercadoLibre country site is its own marketplace, with its own listings, place names and currency.\n\n๐Ÿ“Š **The counts beside each name** were read from the portal's own result counter on 2026-09-13. Venezuela and Uruguay are deep; Guatemala and Paraguay are small enough to sweep whole in a few hundred rows.\n\nโš ๏ธ **Bolivia is not offered** โ€” its entire property section holds 62 listings.", "default": "ve" }, "propertyType": { "title": "๐Ÿ  Property type", "enum": [ "all", "houses", "apartments", "land", "offices", "warehouses", "farms", "commercial-premises", "rooms", "buildings", "townhouses", "hotels", "businesses", "annexes", "club-shares", "garages", "country-houses", "other" ], "type": "string", "description": "๐Ÿ  **READ FROM EACH MARKET'S OWN INDEX**, which is why the list is not identical in every country. Venezuela publishes townhouses, whole buildings, hotels and club memberships that Guatemala does not; Uruguay publishes cocheras and quintas.\n\n๐ŸŒ **The country names after each type say where it exists.**\n\nโš ๏ธ **Pick a type a market does not publish** and the run says so plainly instead of quietly handing back the unfiltered market.", "default": "all" }, "listingOperation": { "title": "๐Ÿค For sale or for rent", "enum": [ "all", "venta", "alquiler", "alquiler-temporada" ], "type": "string", "description": "๐Ÿค **SALE, RENT, OR BOTH IN ONE DATASET.** Venta listings carry an asking price, alquiler listings a monthly rent, and every row is labelled either way โ€” so both can sit side by side for a yield calculation.\n\n๐Ÿ–๏ธ **Alquiler temporada** (seasonal and holiday rent) is a separate operation in Uruguay only, where it runs to roughly 15,000 listings along the coast.", "default": "venta" }, "places": { "title": "๐Ÿ“ Departments to sweep", "uniqueItems": true, "type": "array", "description": "๐Ÿ“ **DEPARTMENTS AND STATES**, each prefixed with its market and carrying the listings it held on 2026-09-13, from the portal's own place index.\n\n๐ŸŒŽ **Leave it on \"The whole market\"** to sweep everything, or pick only the places you want โ€” they run one after another.\n\nโš ๏ธ **A place from another market is skipped and reported**, never swapped for one of this market's.\n\n๐Ÿ”Ž **A department too big for one request** is walked down into its own cities until your result budget is met.", "items": { "type": "string", "enum": [ "all", "ve-amazonas", "ve-anzoategui", "ve-apure", "ve-aragua", "ve-barinas", "ve-bolivar", "ve-carabobo", "ve-cojedes", "ve-distrito-capital", "ve-falcon", "ve-guarico", "ve-lara", "ve-miranda", "ve-monagas", "ve-merida", "ve-nueva-esparta", "ve-portuguesa", "ve-sucre", "ve-trujillo", "ve-tachira", "ve-vargas", "ve-yaracuy", "ve-zulia", "uy-artigas", "uy-canelones", "uy-cerro-largo", "uy-colonia", "uy-durazno", "uy-flores", "uy-florida", "uy-lavalleja", "uy-maldonado", "uy-montevideo", "uy-paysandu", "uy-rivera", "uy-rocha", "uy-rio-negro", "uy-salto", "uy-san-jose", "uy-soriano", "uy-tacuarembo", "uy-treinta-y-tres", "py-alto-parana", "py-asuncion-dc", "py-caaguazu", "py-caazapa", "py-central", "py-cordillera", "py-itapua", "py-paraguari", "py-presidente-hayes", "py-san-pedro", "gt-alta-verapaz", "gt-chimaltenango", "gt-chiquimula", "gt-el-progreso", "gt-escuintla", "gt-guatemala", "gt-huehuetenango", "gt-izabal", "gt-jutiapa", "gt-quetzaltenango", "gt-sacatepequez", "gt-santa-rosa", "gt-solola", "gt-suchitepequez" ], "enumTitles": [ "๐ŸŒŽ The whole market", "๐Ÿ‡ป๐Ÿ‡ช Amazonas (6)", "๐Ÿ‡ป๐Ÿ‡ช Anzoรกtegui (2,657)", "๐Ÿ‡ป๐Ÿ‡ช Apure (10)", "๐Ÿ‡ป๐Ÿ‡ช Aragua (7,448)", "๐Ÿ‡ป๐Ÿ‡ช Barinas (58)", "๐Ÿ‡ป๐Ÿ‡ช Bolรญvar (453)", "๐Ÿ‡ป๐Ÿ‡ช Carabobo (29,699)", "๐Ÿ‡ป๐Ÿ‡ช Cojedes (174)", "๐Ÿ‡ป๐Ÿ‡ช Distrito Capital (87,791)", "๐Ÿ‡ป๐Ÿ‡ช Falcรณn (2,037)", "๐Ÿ‡ป๐Ÿ‡ช Guรกrico (121)", "๐Ÿ‡ป๐Ÿ‡ช Lara (7,906)", "๐Ÿ‡ป๐Ÿ‡ช Miranda (6,196)", "๐Ÿ‡ป๐Ÿ‡ช Monagas (519)", "๐Ÿ‡ป๐Ÿ‡ช Mรฉrida (400)", "๐Ÿ‡ป๐Ÿ‡ช Nueva Esparta (2,229)", "๐Ÿ‡ป๐Ÿ‡ช Portuguesa (200)", "๐Ÿ‡ป๐Ÿ‡ช Sucre (84)", "๐Ÿ‡ป๐Ÿ‡ช Trujillo (126)", "๐Ÿ‡ป๐Ÿ‡ช Tรกchira (652)", "๐Ÿ‡ป๐Ÿ‡ช Vargas (340)", "๐Ÿ‡ป๐Ÿ‡ช Yaracuy (158)", "๐Ÿ‡ป๐Ÿ‡ช Zulia (1,410)", "๐Ÿ‡บ๐Ÿ‡พ Artigas (36)", "๐Ÿ‡บ๐Ÿ‡พ Canelones (14,232)", "๐Ÿ‡บ๐Ÿ‡พ Cerro Largo (80)", "๐Ÿ‡บ๐Ÿ‡พ Colonia (4,823)", "๐Ÿ‡บ๐Ÿ‡พ Durazno (262)", "๐Ÿ‡บ๐Ÿ‡พ Flores (32)", "๐Ÿ‡บ๐Ÿ‡พ Florida (240)", "๐Ÿ‡บ๐Ÿ‡พ Lavalleja (756)", "๐Ÿ‡บ๐Ÿ‡พ Maldonado (89,481)", "๐Ÿ‡บ๐Ÿ‡พ Montevideo (68,908)", "๐Ÿ‡บ๐Ÿ‡พ Paysandรบ (428)", "๐Ÿ‡บ๐Ÿ‡พ Rivera (148)", "๐Ÿ‡บ๐Ÿ‡พ Rocha (3,210)", "๐Ÿ‡บ๐Ÿ‡พ Rรญo Negro (82)", "๐Ÿ‡บ๐Ÿ‡พ Salto (198)", "๐Ÿ‡บ๐Ÿ‡พ San Josรฉ (1,046)", "๐Ÿ‡บ๐Ÿ‡พ Soriano (202)", "๐Ÿ‡บ๐Ÿ‡พ Tacuarembรณ (110)", "๐Ÿ‡บ๐Ÿ‡พ Treinta y Tres (144)", "๐Ÿ‡ต๐Ÿ‡พ Alto Paranรก (14)", "๐Ÿ‡ต๐Ÿ‡พ Asunciรณn D.C. (117)", "๐Ÿ‡ต๐Ÿ‡พ Caaguazรบ (15)", "๐Ÿ‡ต๐Ÿ‡พ Caazapรก (5)", "๐Ÿ‡ต๐Ÿ‡พ Central (50)", "๐Ÿ‡ต๐Ÿ‡พ Cordillera (18)", "๐Ÿ‡ต๐Ÿ‡พ Itapรบa (362)", "๐Ÿ‡ต๐Ÿ‡พ Paraguarรญ (5)", "๐Ÿ‡ต๐Ÿ‡พ Presidente Hayes (3)", "๐Ÿ‡ต๐Ÿ‡พ San Pedro (3)", "๐Ÿ‡ฌ๐Ÿ‡น Alta Verapaz (8)", "๐Ÿ‡ฌ๐Ÿ‡น Chimaltenango (6)", "๐Ÿ‡ฌ๐Ÿ‡น Chiquimula (12)", "๐Ÿ‡ฌ๐Ÿ‡น El Progreso (5)", "๐Ÿ‡ฌ๐Ÿ‡น Escuintla (30)", "๐Ÿ‡ฌ๐Ÿ‡น Guatemala (479)", "๐Ÿ‡ฌ๐Ÿ‡น Huehuetenango (4)", "๐Ÿ‡ฌ๐Ÿ‡น Izabal (13)", "๐Ÿ‡ฌ๐Ÿ‡น Jutiapa (5)", "๐Ÿ‡ฌ๐Ÿ‡น Quetzaltenango (10)", "๐Ÿ‡ฌ๐Ÿ‡น Sacatepรฉquez (111)", "๐Ÿ‡ฌ๐Ÿ‡น Santa Rosa (11)", "๐Ÿ‡ฌ๐Ÿ‡น Sololรก (4)", "๐Ÿ‡ฌ๐Ÿ‡น Suchitepรฉquez (8)" ] }, "default": [ "all" ] }, "maxResults": { "title": "๐Ÿ”ข Max listings", "minimum": 1, "maximum": 20000, "type": "integer", "description": "๐Ÿ”ข **STOPS THE RUN** once this many listings have been returned. Each request brings back 48, so 100 is roughly two requests.\n\n๐Ÿ†“ **Free Apify accounts** are capped at 25 rows per run whatever this says. Paid accounts run to the number you set, or to the size of the market you chose.", "default": 100 }, "includeDetails": { "title": "๐Ÿ“„ Also open each listing's own page", "type": "boolean", "description": "๐Ÿ“„ **OFF BY DEFAULT.** Switch it on and every search row is completed by opening the listing's own page: the full seller description, the complete attribute table, every photo and the map coordinates.\n\n๐Ÿ’ฐ **It costs one extra request per listing** and bills the Property Detail event once per listing. Turn it on when you need the description; leave it off when price, rooms, area and place are enough.", "default": false }, "searchUrls": { "title": "๐ŸŒ MercadoLibre search addresses", "uniqueItems": true, "type": "array", "description": "๐ŸŒ **OPTIONAL SHORTCUT.** Paste MercadoLibre property search addresses exactly as they appear in your browser and the Actor reads those instead of composing its own. Any of the four markets is accepted.\n\n๐Ÿ“‹ **BULK EDIT:** click \"Bulk edit\" to paste one address per line, or upload a .txt file.\n\n๐Ÿšซ **NOT accepted:** addresses carrying the portal's pagination or price-range tokens. Those are refused with an explanation, because MercadoLibre's robots.txt asks general crawlers not to request them.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingUrls": { "title": "๐Ÿ”— Listing addresses", "uniqueItems": true, "type": "array", "description": "๐Ÿ”— **USED BY PROPERTY DETAIL.** One full MercadoLibre listing address per line, exactly as it appears in your browser โ€” for example https://casa.mercadolibre.com.uy/MLU-700095975-casa-en-venta-_JM\n\n๐Ÿ“‹ **BULK EDIT:** click \"Bulk edit\" to paste many at once, or upload a .txt file.\n\n๐Ÿ’ฐ **Duplicates are removed** before anything is charged.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }