{ "openapi": "3.0.1", "info": { "title": "Property Data API - Parcels, Zoning, Owners and Risk", "description": "Look up any US address and read the land record: parcel boundaries and APN, ownership, county assessment with building detail, zoning district with setbacks, height limits and floor area ratio, recorded sale and loan history, owner phone numbers, flood zone and hazard risk.", "version": "0.1", "x-build-id": "izKvnTroVsihEhFuf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~commercial-property-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-commercial-property-data-api", "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/nabeelbaghoor~commercial-property-data-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-commercial-property-data-api", "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/nabeelbaghoor~commercial-property-data-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-commercial-property-data-api", "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": { "mode": { "title": "What to read", "enum": [ "parcel", "assessment", "structures", "zoning", "transactions", "owners", "flood", "risk", "wetlands", "schools", "locationInfo", "geocode", "taxHistory", "assessedValueHistory" ], "type": "string", "description": "Each option reads one of the provider's services. Every service sits behind the same key but is licensed separately, so a service that is not part of your agreement will say so rather than returning nothing.", "default": "parcel" }, "addresses": { "title": "Property addresses", "type": "array", "description": "One property address per line, for example \"100 Main St, Denver, CO 80202\". This is the normal way to use the actor: every service accepts an address.", "items": { "type": "string" } }, "coordinates": { "title": "Coordinates", "type": "array", "description": "One \"latitude, longitude\" pair per line, for example \"39.7392, -104.9903\". Accepted by the parcel, flood, risk, wetlands and geocode modes, which return everything within the search area rather than a single match.", "items": { "type": "string" } }, "identifiers": { "title": "Provider identifiers", "type": "array", "description": "One provider identifier per line, taken from the lightBoxId, parcelId or assessmentId column of an earlier run. Skips the address match, which is faster and exact. Parcel identifiers work with the parcel, structures, zoning, owners, flood, risk and wetlands modes; assessment identifiers work with the assessment, transactions and history modes.", "items": { "type": "string" } }, "bufferDistance": { "title": "Search buffer", "minimum": 0, "type": "number", "description": "Coordinate lookups only. How far around each point to search. Leave empty to search the exact point, which returns just the parcel or zone it falls in." }, "bufferUnit": { "title": "Buffer unit", "enum": [ "ft", "m", "mi", "km" ], "type": "string", "description": "The unit for the search buffer above.", "default": "ft" }, "includeAssessmentWithOwners": { "title": "Include the assessment with owner contacts", "type": "boolean", "description": "Owner contacts mode. Returns the county assessment alongside each contact, so the property's values and characteristics arrive in the same call rather than needing a second run.", "default": false }, "maxResults": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "The most rows this run will save and charge for. A coordinate search with a buffer, a sale history and an owner lookup can each return many rows per address, so allow room for those modes.", "default": 500 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "How fast to call the provider. Lower this if your agreement rate limits the run.", "default": 120 }, "apiKey": { "title": "API key", "type": "string", "description": "Your own API key for the property data provider, sent in its x-api-key header. This actor is bring your own key: it never uses anyone else's credentials, and the key is stored as a secret." } } }, "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 } } } } } } } } } }