{ "openapi": "3.0.1", "info": { "title": "LatAm Real Estate Feed: Fincaraiz, Metrocuadrado and InfoCasas", "description": "Property listings from Fincaraiz and Metrocuadrado (Colombia) and InfoCasas (Uruguay, Paraguay, Bolivia) in one clean schema: price, price per m2, area, rooms, stratum, location and amenities. \"New or price change\" mode for daily monitoring. No personal contact data.", "version": "0.1", "x-build-id": "hHHXGnFLDEfjB2GvY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ceibadata~latam-real-estate-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ceibadata-latam-real-estate-feed", "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/ceibadata~latam-real-estate-feed/runs": { "post": { "operationId": "runs-sync-ceibadata-latam-real-estate-feed", "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/ceibadata~latam-real-estate-feed/run-sync": { "post": { "operationId": "run-sync-ceibadata-latam-real-estate-feed", "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 result URLs", "type": "array", "description": "Paste search result pages from fincaraiz.com.co, metrocuadrado.com, infocasas.com.uy, infocasas.com.py or infocasas.com.bo (set filters on the site, then copy the URL). Every page of each search is read until the limits below. Metrocuadrado shows about 50-65 listings per search page, so its neighbourhood pages are read too.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searches": { "title": "Structured searches (for API and AI agents)", "type": "array", "description": "Alternative to URLs: objects like {\"portal\": \"fincaraiz-co\", \"operation\": \"sale\", \"propertyType\": \"apartamentos\", \"location\": \"medellin\"}. portal: fincaraiz-co, metrocuadrado-co, infocasas-uy, infocasas-py or infocasas-bo; operation: sale or rent." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after delivering this many listings in total.", "default": 100 }, "maxPagesPerSearch": { "title": "Maximum pages per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Each page has about 21 listings (Metrocuadrado: about 50-65, one page per neighbourhood).", "default": 20 }, "onlyNewOrChanged": { "title": "Only new listings or price changes", "type": "boolean", "description": "Remember what earlier runs delivered for the same searches and return only listings that are new or changed price since then (changeType tells which). Ideal for scheduled daily runs.", "default": false }, "minPrice": { "title": "Minimum price", "type": "integer", "description": "In the listing's currency." }, "maxPrice": { "title": "Maximum price", "type": "integer", "description": "In the listing's currency." }, "minBedrooms": { "title": "Minimum bedrooms", "type": "integer", "description": "Skip listings with fewer bedrooms." }, "minAreaM2": { "title": "Minimum area (m²)", "type": "integer", "description": "Private area when available, else built or total area." }, "excludePrivateSellers": { "title": "Only agency listings", "type": "boolean", "description": "Skip listings published by private owners.", "default": false }, "delayMs": { "title": "Delay between pages (ms)", "minimum": 1000, "type": "integer", "description": "Polite pause between page requests. Minimum 1000.", "default": 1500 } } }, "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 } } } } } } } } } }