{
  "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": "hwXGc2KboblmH8XbJ"
  },
  "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'), a city ('St. Augustine, FL' or 'saint augustine florida') or a 5-digit ZIP code ('85323'). A city becomes its county plus a city filter, a ZIP 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 where the county's server applies the filter (ZIP, city or value on most feeds); row-by-row filters (absentee, owner type, property type, bedrooms, or a ZIP on a feed with no ZIP column) are applied during export, and count_basis says when the preview is from 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, punctuation and 'St.'/'Saint' do 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."
          },
          "minBedrooms": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Bedrooms, where the county publishes them (run with 'List coverage only' to see which do). A county that does not is skipped with a free notice; parcels with no count are left out."
          },
          "maxBedrooms": {
            "title": "Maximum bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Bedrooms, where the county publishes them."
          },
          "minBathrooms": {
            "title": "Minimum bathrooms",
            "minimum": 0,
            "type": "number",
            "description": "Bathrooms, as the county counts them. Cook County and New York publish full baths only, so a 2.5-bath home there reads 2."
          },
          "maxBathrooms": {
            "title": "Maximum bathrooms",
            "minimum": 0,
            "type": "number",
            "description": "Bathrooms, where the county publishes them."
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}