{ "openapi": "3.0.1", "info": { "title": "Estrenarvivienda.com Scraper - Inmuebles en Venta Colombia", "description": "Scrape new-build homes, projects and builders from Estrenarvivienda.com (Colombia): prices, delivery dates, VIS. Export CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "9udt5CYOSSanRfd0A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~estrenarvivienda-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-estrenarvivienda-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/recordsdata~estrenarvivienda-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-estrenarvivienda-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/recordsdata~estrenarvivienda-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-estrenarvivienda-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": "Start URLs", "type": "array", "description": "Estrenarvivienda.com pages to read: a unit URL (https://www.estrenarvivienda.com//), a project page, a builder page (/constructora-), or a category, collection or city page such as /apartamentos/bogota or /vivienda-interes-social. Leave empty to search the whole portal with the filters below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingIds": { "title": "Listing IDs", "type": "array", "description": "Unit IDs (the number at the end of a unit URL, for example 51586) to read directly. Added to anything found through the start URLs.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "entity": { "title": "Record type", "enum": [ "listings", "projects", "builders" ], "type": "string", "description": "What each row is: a unit type (listings), a whole development with its price and size ranges (projects), or a builder with its portfolio (builders).", "default": "listings" }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest", "priceAsc", "priceDesc", "areaAsc", "areaDesc", "nameAsc" ], "type": "string", "description": "Order of the rows. Newest first is the portal order. Other orders read the whole matching catalog first.", "default": "newest" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Only these property types. Empty means all.", "items": { "type": "string", "enum": [ "apartment", "house", "studio", "lot" ], "enumTitles": [ "Apartment", "House", "Studio apartment", "Lot" ] }, "default": [] }, "departments": { "title": "Departments", "type": "array", "description": "Colombian departments to include.", "items": { "type": "string", "enum": [ "Antioquia", "Atlántico", "Bolívar", "Boyacá", "Caldas", "Cauca", "Cesar", "Cundinamarca", "Córdoba", "Huila", "Magdalena", "Meta", "Quindio", "Risaralda", "Santander", "Tolima", "Valle del Cauca" ] }, "default": [] }, "cities": { "title": "Cities", "type": "array", "description": "Cities and municipalities to include.", "items": { "type": "string", "enum": [ "Armenia", "Barrancabermeja", "Barranquilla", "Bello", "Bogotá", "Bucaramanga", "Cajicá", "Calarcá", "Caldas", "Cali", "Candelaria", "Cartagena", "Chinchiná", "Chía", "Circasia", "Combia", "Cota", "Dosquebradas", "El Cerrito", "Envigado", "Filandia", "Floridablanca", "Funza", "Fusagasugá", "Girardot", "Girón", "Ibagué", "Itagüí", "Jamundí", "La Calera", "La Mesa", "La Tebaida", "La Unión", "Madrid", "Manizales", "Medellín", "Melgar", "Montenegro", "Montería", "Mosquera", "Neiva", "Nemocón", "Paipa", "Palmira", "Pereira", "Piedecuesta", "Pitalito", "Popayán", "Puerto Colombia", "Quimbaya", "Ricaurte", "Rionegro", "Sabaneta", "Santa Marta", "Santa Rosa de Cabal", "Soacha", "Soledad", "Tocaima", "Tocancipá", "Tunja", "Valledupar", "Villamaría", "Villavicencio", "Villeta", "Yumbo", "Zipaquirá" ] }, "default": [] }, "zones": { "title": "Zones", "type": "array", "description": "City zones by name, for example Chapinero or Norte. Matched against the portal list inside the cities above when you set them.", "default": [], "items": { "type": "string" } }, "neighborhoods": { "title": "Neighborhoods", "type": "array", "description": "Neighborhoods by name, for example Chicó or Cedritos.", "default": [], "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (COP)", "minimum": 0, "type": "integer", "description": "Lowest unit price in Colombian pesos." }, "maxPrice": { "title": "Maximum price (COP)", "minimum": 0, "type": "integer", "description": "Highest unit price in Colombian pesos." }, "minArea": { "title": "Minimum area (m2)", "minimum": 0, "type": "integer", "description": "Smallest built area in square meters." }, "maxArea": { "title": "Maximum area (m2)", "minimum": 0, "type": "integer", "description": "Largest built area in square meters." }, "bedrooms": { "title": "Bedrooms", "type": "array", "description": "Number of bedrooms to include (any of them).", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ] }, "default": [] }, "bathrooms": { "title": "Bathrooms", "type": "array", "description": "Number of bathrooms to include (any of them).", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ] }, "default": [] }, "parking": { "title": "Parking spaces", "type": "array", "description": "Parking spaces per unit (any of them). Communal means shared parking.", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "5", "communal" ], "enumTitles": [ "None", "1", "2", "3", "4", "5", "Communal" ] }, "default": [] }, "stratum": { "title": "Socioeconomic stratum", "type": "array", "description": "Colombian stratum 1 to 6, Rural, or Por definir (to be defined).", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "Rural", "Por definir" ] }, "default": [] }, "deliveryYears": { "title": "Delivery years", "type": "array", "description": "Planned delivery years to include.", "items": { "type": "string", "enum": [ "2026", "2027", "2028", "2029", "2030", "2031", "2032" ] }, "default": [] }, "housingSegment": { "title": "Housing segment", "enum": [ "any", "vis", "novis" ], "type": "string", "description": "VIS and VIP are the subsidised social-interest segments; the other segment is everything else.", "default": "any" }, "collection": { "title": "Collection", "enum": [ "any", "immediateDelivery", "outlet", "shortTermRental", "vacation", "petFriendly", "countryside", "launches", "coworking", "miCasaYa", "premium", "sustainable", "subsidyCaja", "subsidyHabitat" ], "type": "string", "description": "Only units from one of the portal collections.", "default": "any" }, "builders": { "title": "Builders", "type": "array", "description": "Keep only units from builders whose name contains one of these texts, for example Amarilo or Bolivar.", "default": [], "items": { "type": "string" } }, "amenities": { "title": "Amenities", "type": "array", "description": "Projects with any of these amenities.", "items": { "type": "string", "enum": [ "Portería / Recepción / Lobby", "Gimnasio", "Salón Comunal", "Piscina Familiar", "BBQ", "Centro de Negocios - Coworking", "Piscina para Niños", "Parque Infantil", "Terraza", "Salón de Juegos", "Cancha Múltiple", "Bicicleteros", "Sauna", "Sendero de trote", "Turco", "Gimnasio semidotado", "Jacuzzi", "Teatrino", "Lavandería", "Áreas de fogatas", "Salas de Videojuegos", "Cancha de Tenis", "Cocina Social", "Solarium", "Cancha de Squash", "Centros de SPA", "Guardería", "Puntos de Reciclaje", "Plazoleta de Comidas", "Huertos Comunitarios", "Cuarto de Escoltas", "Salón de Música" ] }, "default": [] }, "includeDetails": { "title": "Include detail page data", "type": "boolean", "description": "Open each unit page for the publication date, address, private area, garage type, view, levels, balcony, interior features, finishes text, tower data, office hours, video and floor plans. Billed as an extra event per row with data. Applies to listings only.", "default": false }, "includeCollections": { "title": "Include collections", "type": "boolean", "description": "Add the list of portal collections each unit or project belongs to (outlet, launches, premium, and so on). Adds about a dozen requests per run.", "default": false }, "includeContactDetails": { "title": "Include builder sales phone", "type": "boolean", "description": "Add the builder sales phone and WhatsApp line published on the portal. Business contact only, no private sellers exist on this portal.", "default": false }, "onlyNew": { "title": "Only new or changed", "type": "boolean", "description": "Return only rows not delivered by earlier runs with the same filters, or whose price changed. Marks each row new or changed.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Optional name for the saved monitor state. Use different names to keep separate watches with the same filters.", "default": "" }, "resetSeen": { "title": "Reset monitor", "type": "boolean", "description": "Forget everything delivered so far and start the monitor over.", "default": 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 } } } } } } } } } }