{ "openapi": "3.0.1", "info": { "title": "US county property tax lookup", "description": "One parcel lookup across US counties that publish the same data completely different ways. Returns a normalized record that labels what each number means and flags what the caller has to know to avoid being wrong.", "version": "0.1", "x-build-id": "GRhbHGwMZEVjEq1ff" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mikhail.koviazin~actor-us-tax-county-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mikhail.koviazin-actor-us-tax-county-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/mikhail.koviazin~actor-us-tax-county-scraper/runs": { "post": { "operationId": "runs-sync-mikhail.koviazin-actor-us-tax-county-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/mikhail.koviazin~actor-us-tax-county-scraper/run-sync": { "post": { "operationId": "run-sync-mikhail.koviazin-actor-us-tax-county-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", "required": [ "jurisdiction", "query" ], "properties": { "jurisdiction": { "title": "County", "enum": [ "san-diego-ca", "duval-fl", "cook-il", "travis-tx" ], "type": "string", "description": "Which county to ask. There is no auto-detection: resolving a county from an address is a separate problem, and guessing it wrong returns a confident answer about the wrong property. Each county is reached a completely different way, which affects how fast the answer comes and how fresh it is. Travis is the exception on the platform: the index it answers from is built locally and the platform build ships none, so a Travis lookup returns the refusal index_not_built instead of data.", "default": "san-diego-ca" }, "lookupBy": { "title": "Look up by", "enum": [ "parcel_id", "address" ], "type": "string", "description": "Whether the query is a parcel identifier or a street address. State it explicitly. It is never inferred from the shape of the string, because parcel identifiers have no common format and some of them look like house numbers.", "default": "parcel_id" }, "query": { "title": "Parcel identifier or address", "type": "string", "description": "The parcel identifier or the street address. No format is enforced: identifiers differ per county and cannot be validated beyond 'not empty'. One real example each: San Diego 3532803300, Duval 0991354355R, Cook 29352110190000, Travis 100008 (unpadded; the export pads it to twelve). For an address give as much as you have, for example '7519 Caravaca Ct, Jacksonville, FL 32244'. An address naming a building rather than a parcel, such as a condominium tower, returns every unit and flags it." }, "allowContestedOwnerNames": { "title": "Include owner names whose publication is disputed", "type": "boolean", "description": "Whether to return owner names where two publishers of the same data disagree about putting them online. Affects San Diego only. Left false, the parcel comes back complete with the name and mailing address withheld and flagged owner_withheld_by_policy. Set true and the name is returned flagged owner_name_contested, so the dispute travels with the data. The disagreement: the assessor serves the name unauthenticated, the county GIS agency says California AB1785 bars publishing it online.", "default": false }, "maxResults": { "title": "Maximum records", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many parcels to return at most. Address lookups are ambiguous by nature: a house number and a street name are not unique across a county of a million parcels, and one condominium address can be hundreds of parcels. When more matched than were returned, the record says so in result_set and flags results_truncated.", "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 } } } } } } } } } }