{ "openapi": "3.0.1", "info": { "title": "Florida Property Tax Roll - DOR NAL Assessments", "description": "Florida DOR statewide property tax roll (NAL), all 67 counties (public record): just/assessed/taxable values, land and homestead value, owner and mailing address, situs address, building attributes and the latest sale with its DOR code. Search by owner, county, value or use code.", "version": "0.0", "x-build-id": "Nc0vuicK5r3rpvYRa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/j0401~fl-tax-roll-nal/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-j0401-fl-tax-roll-nal", "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/j0401~fl-tax-roll-nal/runs": { "post": { "operationId": "runs-sync-j0401-fl-tax-roll-nal", "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/j0401~fl-tax-roll-nal/run-sync": { "post": { "operationId": "run-sync-j0401-fl-tax-roll-nal", "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": "Mode", "enum": [ "", "search", "lookup", "aggregate" ], "type": "string", "description": "lookup = one parcel id's record. aggregate = one row per group. Leave blank to auto-route: a bare parcelId -> lookup, otherwise search (or aggregate when aggregate=true)." }, "parcelId": { "title": "Parcel id", "type": "string", "description": "Exact county parcel id (the NAL PARCEL_ID field). Combine with `county` to disambiguate, since parcel ids are only unique within a county." }, "county": { "title": "County", "type": "string", "description": "Florida county name, substring, case-insensitive (e.g. \"Miami-Dade\", \"Broward\", \"Lee\"). Or pass the 2-digit DOR county number (e.g. \"23\"). Spacing and punctuation are ignored, so \"Miami Dade\", \"St Johns\" and \"Broward County\" all work; a value matching no county is rejected. Filtering by county also pins a single file, which is what keeps a run fast - without it the actor streams all 67 files (about 15-20 minutes)." }, "ownerName": { "title": "Owner name", "type": "string", "description": "Owner name substring, case-insensitive (e.g. \"SMITH\" or \"ACME HOLDINGS\")." }, "city": { "title": "Situs city", "type": "string", "description": "Property (physical) city, substring, case-insensitive." }, "zipCode": { "title": "Situs ZIP prefix", "type": "string", "description": "Property (physical) ZIP prefix, digits only." }, "dorUseCode": { "title": "DOR use code", "type": "string", "description": "Florida DOR land use code, exact match (3 digits, zero-padded). Codes run in blocks: 000-009 residential (e.g. \"001\" single family, \"004\" condominium), 010-039 commercial, 040-049 industrial, 050-069 agricultural, 070-099 institutional, government and miscellaneous." }, "appraiserStatusCode": { "title": "Appraiser status code", "type": "string", "description": "Appraiser assessment status code, exact match. The code is the county appraiser's own status marker; it is blank on most parcels (about 56% statewide), so it is a narrow filter rather than a primary dimension." }, "valueMin": { "title": "Minimum just value", "type": "number", "description": "Lowest just (market) value in USD. Value filters only return parcels that record a value." }, "valueMax": { "title": "Maximum just value", "type": "number", "description": "Highest just (market) value in USD." }, "landValueMin": { "title": "Minimum land value", "type": "number", "description": "Lowest land value in USD." }, "landValueMax": { "title": "Maximum land value", "type": "number", "description": "Highest land value in USD." }, "homesteadOnly": { "title": "Homestead parcels only", "type": "boolean", "description": "true = only parcels carrying a homestead value (a Florida homestead exemption); false = only non-homestead; leave unset for all." }, "saleYearFrom": { "title": "Sale year from", "type": "string", "description": "Earliest sale year (inclusive), 4 digits. Filters on the most recent recorded sale year in the roll." }, "saleYearTo": { "title": "Sale year to", "type": "string", "description": "Latest sale year (inclusive), 4 digits." }, "aggregate": { "title": "Aggregate instead of records", "type": "boolean", "description": "When on, returns one summary record per group (with a count) instead of individual parcel records.", "default": false }, "groupBy": { "title": "Aggregate by", "enum": [ "county", "dorUseCode", "appraiserStatusCode", "assessmentYear", "saleYear", "constructionClass" ], "type": "string", "description": "county -> parcels per county; dorUseCode -> the land-use mix; assessmentYear -> the roll year; saleYear -> sales by year; constructionClass -> building class.", "default": "county" }, "maxResults": { "title": "Max records", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Cap the number of parcel records pushed in search/lookup mode (default 200; 0 = the same 200; maximum 20,000). Does not apply in aggregate mode, which returns every group of the chosen dimension.", "default": 200 } } }, "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 } } } } } } } } } }