{ "openapi": "3.0.1", "info": { "title": "Properati Propoperty real estate Scraper", "description": "Scrapes property listings from Properati (Argentina, Colombia, Ecuador, Peru). Extracts price, rooms, surface area, location, features, and full descriptions.", "version": "1.0", "x-build-id": "ECeg5uhyP8RU2D7QF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~properati-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-properati-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/unfenced-group~properati-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-properati-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/unfenced-group~properati-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-properati-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": { "propertyType": { "title": "Property Type", "enum": [ "apartment", "house", "studio", "office", "land", "warehouse", "commercial", "other" ], "type": "string", "description": "Type of property to search for.", "default": "apartment" }, "location": { "title": "Location", "type": "string", "description": "Neighbourhood, city, or area slug as it appears in the Properati URL (e.g. 'capital-federal' for Buenos Aires city, 'palermo', 'belgrano', 'medellin'). Leave empty to search all locations. Tip: browse Properati, find your area, and copy the slug from the URL.", "default": "" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum listing price, in the currency Properati displays for that market (USD for most Argentine sale listings, COP in Colombia, USD in Ecuador). Applied by Properati's own search filter. Leave empty for no minimum." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum listing price, in the currency Properati displays for that market. Applied by Properati's own search filter. Leave empty for no maximum." }, "daysOld": { "title": "Max listing age (days)", "minimum": 0, "type": "integer", "description": "Only return listings published within the last N days. Properati's own filter supports 1, 7 and 30 days; any other value is applied by filtering on each listing's publish date. Leave empty for no recency filter." }, "maxItems": { "title": "Maximum Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of property listings to return. Each listing is one charged result.", "default": 100 }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional: Properati search URLs to scrape instead of using the filters above, e.g. https://www.properati.com.ar/s/palermo/departamento/venta. Any query string on the URL is kept.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "ar", "co", "ec" ], "type": "string", "description": "Country to search in.", "default": "ar" }, "operationType": { "title": "Operation Type", "enum": [ "sale", "rent", "both" ], "type": "string", "description": "Whether to search for properties for sale or for rent.", "default": "sale" }, "fetchDetailsEnabled": { "title": "Fetch Property Details", "type": "boolean", "description": "If enabled, fetches each property detail page to add the full description, surface area, exact street address, coordinates and the complete features list. Adds one request per listing.", "default": true }, "maxConcurrency": { "title": "Max Concurrent Requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of parallel requests when fetching detail pages. Lower values are gentler on the server.", "default": 5 } } }, "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 } } }, "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 } } } } } } } } } }