{
  "openapi": "3.0.1",
  "info": {
    "title": "Property Owner Records - Absentee Owner Lists by County",
    "description": "Absentee-owner and direct-mail lists from official statewide parcel layers (FL, NC, WI, CT, AR, MA, NY, VT, MN, NJ, MD): owner name, mailing address, value, last sale. NJ and MD publish no owner names; AR no mailing addresses. Filter by absentee or out-of-state owner, value, sale date, owner name.",
    "version": "0.1",
    "x-build-id": "bc7aGIKZ7HBaXMQj9"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/neverempty~statewide-property-owners/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-neverempty-statewide-property-owners",
        "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/neverempty~statewide-property-owners/runs": {
      "post": {
        "operationId": "runs-sync-neverempty-statewide-property-owners",
        "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/neverempty~statewide-property-owners/run-sync": {
      "post": {
        "operationId": "run-sync-neverempty-statewide-property-owners",
        "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": "Counties, towns or states",
            "type": "array",
            "description": "One area per line: a county with its state (\"Alachua, FL\", \"Wake County, NC\"), a whole state (\"VT\" or \"Vermont\"), or a town in Massachusetts, Vermont or Connecticut (\"Brookline, MA\"). Supported states: FL, NC, WI, CT, AR, MA, NY, VT, MN, NJ, MD. Connecticut has no county governments; use one of its 9 planning regions (for example \"Capitol Region, CT\") or a town. New York City's five boroughs (Bronx, Kings, New York, Queens, Richmond) come with owner names and property addresses but no mailing address or value.",
            "items": {
              "type": "string"
            }
          },
          "absenteeOwners": {
            "title": "Owner occupancy",
            "enum": [
              "any",
              "absentee",
              "out_of_state",
              "owner_occupied"
            ],
            "type": "string",
            "description": "absentee = the owner's mailing address is in another state, or has a different house number than the property. out_of_state = the mailing address is in another state or country. owner_occupied = the mailing address has the same house number and street as the property (unit numbers are not compared). Properties where this cannot be told (no mailing address, PO box, no house number) are left out of all three.",
            "default": "any"
          },
          "minValueUsd": {
            "title": "Minimum value (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep properties whose value is at least this many dollars. The value is the one each state publishes (market value in most states, assessed value in some); every row says which in valueBasis. Properties with no value are left out when this is set."
          },
          "maxValueUsd": {
            "title": "Maximum value (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep properties whose value is at most this many dollars."
          },
          "soldFrom": {
            "title": "Last sold from (YYYY-MM-DD)",
            "type": "string",
            "description": "Keep properties whose most recent recorded sale is on or after this date. Wisconsin, New York, Vermont and Arkansas publish no sale dates statewide, so areas there are left out (with a note row) when a sale range is set. Florida records the sale month only.",
            "default": ""
          },
          "soldTo": {
            "title": "Last sold to (YYYY-MM-DD)",
            "type": "string",
            "description": "Latest sale date. Empty means today.",
            "default": ""
          },
          "ownerName": {
            "title": "Owner name contains",
            "type": "string",
            "description": "Keep properties whose owner name contains this text, such as SMITH, LLC or TRUST. Case does not matter."
          },
          "maxResultsPerArea": {
            "title": "Maximum records per area",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "The most property records returned for each area line. One record is one parcel.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}