{ "openapi": "3.0.1", "info": { "title": "Properati Scraper | LATAM Real Estate Listings & Property API", "description": "Scrape Properati real estate listings in Argentina, Colombia, Peru and Ecuador. Export price in USD and local currency, price per m2, beds, baths, area, coordinates, amenities, images, agency and agent phone and WhatsApp. Any search URL, sale or rent. Datos inmobiliarios to JSON, CSV, Excel.", "version": "0.1", "x-build-id": "ASOBSGnrxLgaP97Ha" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~properati-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~properati-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-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/scrapers_lat~properati-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-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": { "startUrl": { "title": "Search URL", "type": "string", "description": "A Properati search results URL. Apply any filters on the Properati site (operation, property type, location, price, days published) and paste the resulting URL, for example https://www.properati.com.ar/s/casa/venta or https://www.properati.com.co/s/apartamento/arriendo. Works on any country domain (.com.ar, .com.co, .com.pe, .com.ec ...)." }, "startUrls": { "title": "Search URLs (batch)", "type": "array", "description": "Optional list of Properati search URLs to scrape in one run (in addition to Search URL). Accepts plain strings or {\"url\": \"...\"} objects.", "items": { "type": "string" } }, "maxListings": { "title": "Max listings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of listings to collect across all search URLs. Leave empty for all results (paying plans). Free Apify plans are capped at 10 per run." }, "withDetails": { "title": "Scrape detail pages (paying plans)", "type": "boolean", "description": "When enabled, each listing's detail page is fetched to add the full description, amenities, complete image gallery, publisher/agent phone and WhatsApp, built/lot area, half bathrooms, construction year, maintenance fee and the 'apto crédito' flag. Detail enrichment runs on paying Apify plans only; free runs return the listing-level fields.", "default": true }, "minPrice": { "title": "Min price", "type": "integer", "description": "Only keep listings at or above this price (in the currency set below, or the listing currency)." }, "maxPrice": { "title": "Max price", "type": "integer", "description": "Only keep listings at or below this price." }, "priceCurrency": { "title": "Price currency", "enum": [ "USD", "ARS", "COP", "PEN", "MXN" ], "type": "string", "description": "Currency the min/max price filter is expressed in." }, "minBedrooms": { "title": "Min bedrooms", "type": "integer", "description": "Only keep listings with at least this many bedrooms." }, "maxBedrooms": { "title": "Max bedrooms", "type": "integer", "description": "Only keep listings with at most this many bedrooms." }, "minBathrooms": { "title": "Min bathrooms", "type": "integer", "description": "Only keep listings with at least this many bathrooms." }, "minAreaM2": { "title": "Min area (m²)", "type": "integer", "description": "Only keep listings with total area at or above this many square meters." }, "maxAreaM2": { "title": "Max area (m²)", "type": "integer", "description": "Only keep listings with total area at or below this many square meters." } } }, "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 } } } } } } } } } }