{ "openapi": "3.0.1", "info": { "title": "Commercial Real-Estate Listing Aggregator", "description": "Scrapes and aggregates commercial real-estate re-listings from public sources. Returns structured data including listing ID, title, price, address, square footage, property type, and description. Ideal for investors, brokers, and analysts tracking commercial property market activity.", "version": "0.1", "x-build-id": "fDCNRnjbB4JV78TQZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/slate_spool~commercial-real-estate-listing-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-slate_spool-commercial-real-estate-listing-aggregator", "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/slate_spool~commercial-real-estate-listing-aggregator/runs": { "post": { "operationId": "runs-sync-slate_spool-commercial-real-estate-listing-aggregator", "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/slate_spool~commercial-real-estate-listing-aggregator/run-sync": { "post": { "operationId": "run-sync-slate_spool-commercial-real-estate-listing-aggregator", "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", "required": [ "propertyTypes", "maxItems", "maxRequests", "maxRunSecs", "requestDelayMs", "requestTimeoutSecs", "maxRequestAttempts", "failOnAnyError" ], "properties": { "propertyTypes": { "title": "Property types", "type": "array", "description": "Public listing types to aggregate. Commercial is the default; land is optional.", "items": { "type": "string" }, "default": [ "commercial", "land" ] }, "states": { "title": "State filters", "type": "array", "description": "Optional two-letter US state codes, for example TX or CA.", "items": { "type": "string", "pattern": "^[A-Za-z]{2}$" }, "default": [] }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 250, "type": "integer", "description": "Hard output and charge-event cap.", "default": 25 }, "maxRequests": { "title": "Maximum HTTP requests", "minimum": 2, "maximum": 300, "type": "integer", "description": "Hard request cap including robots.txt and detail calls.", "default": 30 }, "maxRunSecs": { "title": "Maximum run seconds", "minimum": 10, "maximum": 900, "type": "integer", "description": "Hard source-work wall-clock cap.", "default": 180 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 2000, "maximum": 30000, "type": "integer", "description": "Polite sequential delay. The source permits 60 reads/min; this Actor defaults to 20/min and rejects faster than 30/min.", "default": 3000 }, "requestTimeoutSecs": { "title": "Request timeout seconds", "minimum": 5, "maximum": 60, "type": "integer", "description": "Per-request timeout.", "default": 30 }, "maxRequestAttempts": { "title": "Maximum request attempts", "minimum": 1, "maximum": 4, "type": "integer", "description": "Bounded attempts per HTTP request, including the first attempt.", "default": 3 }, "failOnAnyError": { "title": "Fail on any listing error", "type": "boolean", "description": "When enabled, any explicit record error makes the Actor exit nonzero after writing structured evidence.", "default": true }, "includeRunUsage": { "title": "Include usage meter", "type": "boolean", "description": "Include request and cap counters on every listing record.", "default": true } } }, "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 } } } } } } } } } }