{
  "openapi": "3.0.1",
  "info": {
    "title": "US Property Records Export & Owner Lookup (County Assessor)",
    "description": "Export every property in a US county, state or ZIP from the official assessor roll — owner, mailing address, absentee flag, values, last sale, year built — or look up by address, parcel or owner. 511 counties.",
    "version": "0.0",
    "x-build-id": "ZiB4W1XZdeIwHOx4f"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapebench~us-county-property-records-export/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapebench-us-county-property-records-export",
        "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/scrapebench~us-county-property-records-export/runs": {
      "post": {
        "operationId": "runs-sync-scrapebench-us-county-property-records-export",
        "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/scrapebench~us-county-property-records-export/run-sync": {
      "post": {
        "operationId": "run-sync-scrapebench-us-county-property-records-export",
        "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": {
          "areas": {
            "title": "Areas to export",
            "type": "array",
            "description": "One per line. A state ('FL' or 'Florida'), a county ('Miami-Dade, FL', 'Cook County, Illinois', 'IL/Cook') or a 5-digit ZIP code ('85323'). A ZIP becomes its county plus a ZIP filter. An area we don't cover returns a free notice, never an error.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "area": {
            "title": "Area (single)",
            "type": "string",
            "description": "Same as one line of 'Areas to export'; kept for saved tasks and API callers that send one value."
          },
          "preset": {
            "title": "List type (preset)",
            "enum": [
              "none",
              "absentee_owners",
              "out_of_state_owners",
              "company_owners",
              "recent_buyers",
              "long_term_owners",
              "vacant_land"
            ],
            "type": "string",
            "description": "A ready-made filter for common lead lists. Any filter you set below overrides the preset's value for that filter. Absentee presets leave out government owners.",
            "default": "none"
          },
          "countOnly": {
            "title": "Count only (free preview)",
            "type": "boolean",
            "description": "Don't export: return, per area, how many properties match and the estimated cost of exporting them. Free. Counts are exact for ZIP/city/value filters; owner-side filters (absentee, owner type) are applied during export, so the preview shows the count before them.",
            "default": false
          },
          "maxResultsPerArea": {
            "title": "Max rows per area",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Cap on rows returned for EACH area line (not per run), so adding areas never cuts off the later ones. 0 = no cap: the whole filtered area, bounded only by your run's max charge and time.",
            "default": 1000
          },
          "zipCodes": {
            "title": "ZIP codes",
            "type": "array",
            "description": "Only properties in these ZIP codes.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Only properties whose situs (property) city is one of these, e.g. 'OAK LAWN'. Case does not matter.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "propertyUse": {
            "title": "Property type",
            "type": "array",
            "description": "Words to match in the county's property-use description ('single family', 'condo', 'vacant', 'commercial', 'multi') or a class-code prefix. Matches if ANY entry matches.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "ownerTypes": {
            "title": "Owner types",
            "type": "array",
            "description": "Keep only these owner types, one per line: individual, company (LLC, Inc, LP, ...), trust, government. Classified from the owner name.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "absentee": {
            "title": "Owner occupancy",
            "type": "array",
            "description": "Keep only these occupancy tiers, one per line: out_of_state, out_of_city, same_city_diff_address, owner_occupied, unknown. Compares the owner's mailing address with the property; out_of_state and out_of_city are the classic absentee-owner lists, and unknown means the roll has no mailing address to compare.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minValue": {
            "title": "Minimum value ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Market value, or assessed value where the county publishes no market value."
          },
          "maxValue": {
            "title": "Maximum value ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Market value, or assessed value where the county publishes no market value."
          },
          "soldAfter": {
            "title": "Sold on or after",
            "type": "string",
            "description": "YYYY-MM-DD. Keeps properties whose last recorded sale is on or after this date (month precision where the county records only the month)."
          },
          "soldBefore": {
            "title": "Sold before",
            "type": "string",
            "description": "YYYY-MM-DD. Keeps properties whose last recorded sale is before this date."
          },
          "minYearBuilt": {
            "title": "Built in or after (year)",
            "minimum": 1600,
            "type": "integer",
            "description": "Year built, where the county publishes it."
          },
          "maxYearBuilt": {
            "title": "Built in or before (year)",
            "minimum": 1600,
            "type": "integer",
            "description": "Year built, where the county publishes it."
          },
          "lookups": {
            "title": "Lookups (address, parcel or owner)",
            "type": "array",
            "description": "E.g. '1001 Preston St, Houston, TX 77002', 'IL/Cook/17-09-100-001-0000', 'FL/Miami-Dade/ACME HOLDINGS LLC'. No limit on how many per run.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "addresses": {
            "title": "Addresses",
            "type": "array",
            "description": "Street addresses with city, state and preferably ZIP. Same as 'Lookups', but always read as addresses.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "parcelLookups": {
            "title": "Parcel IDs",
            "type": "array",
            "description": "STATE/County/ParcelID, e.g. 'IL/Cook/17-09-100-001-0000'. A bare ID works with the State and County hints below.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "ownerLookups": {
            "title": "Owner names",
            "type": "array",
            "description": "STATE/Owner Name or STATE/County/Owner Name. Matches names that START with what you type. Returns every parcel found plus a free portfolio summary row.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "address": {
            "title": "Address (single)",
            "type": "string",
            "description": "One address; kept for API callers that send one value."
          },
          "parcelLookup": {
            "title": "Parcel ID (single)",
            "type": "string",
            "description": "One parcel lookup."
          },
          "ownerLookup": {
            "title": "Owner name (single)",
            "type": "string",
            "description": "One owner lookup."
          },
          "stateHint": {
            "title": "State hint",
            "type": "string",
            "description": "Two-letter state for bare parcel IDs or owner names, e.g. 'IL'."
          },
          "countyHint": {
            "title": "County hint",
            "type": "string",
            "description": "County for bare parcel IDs or addresses, e.g. 'Cook' (use with State hint)."
          },
          "maxResultsPerOwner": {
            "title": "Max properties per owner",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Cap on properties returned for EACH owner lookup.",
            "default": 50
          },
          "includeHistory": {
            "title": "Include sale and tax history",
            "type": "boolean",
            "description": "Add every recorded sale (with buyer and seller where published) and prior-year values to each row. Turn off for a smaller, flatter dataset.",
            "default": true
          },
          "listCoverage": {
            "title": "List coverage only",
            "type": "boolean",
            "description": "Return one free row per county/state source this actor reads, with the fields each one publishes. Nothing else runs.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. The assessor feeds answer direct requests; enable a proxy only if a run returns a 'blocked' notice.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}