api.locus.report

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {},
  "description": "A cited comps-brief artifact: recorded-sale comp rows (parcel, site address, date, price, and price per LAND square foot where lot acreage is published) within 1500m / 24 months, plus median sale price, min/max range, median price per land square foot, and a coarse up/flat/down trend; provenance, per-source status, and Register-of-Deeds verify links. Arithmetic over public records - never a valuation, appraisal, AVM, or price prediction. A miss returns charged:false.",
  "properties": {
    "caveats": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "charged": {
      "type": "boolean"
    },
    "componentStatus": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "component": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "component",
          "status"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "comps": {
      "items": {
        "additionalProperties": {},
        "properties": {},
        "type": "object"
      },
      "type": "array"
    },
    "county": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string"
    },
    "kind": {
      "const": "comps_brief",
      "type": "string"
    },
    "medianPrice": {
      "type": "number"
    },
    "medianPricePerLandSqft": {
      "type": "number"
    },
    "point": {
      "additionalProperties": false,
      "properties": {
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        }
      },
      "required": [
        "latitude",
        "longitude"
      ],
      "type": "object"
    },
    "priceRange": {
      "additionalProperties": false,
      "properties": {
        "max": {
          "type": "number"
        },
        "min": {
          "type": "number"
        }
      },
      "required": [
        "min",
        "max"
      ],
      "type": "object"
    },
    "provenance": {
      "additionalProperties": {},
      "properties": {},
      "type": "object"
    },
    "query": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "enum": [
            "county",
            "address",
            "point"
          ],
          "type": "string"
        },
        "monthsBack": {
          "type": "number"
        },
        "radiusMeters": {
          "type": "number"
        }
      },
      "required": [
        "mode",
        "radiusMeters",
        "monthsBack"
      ],
      "type": "object"
    },
    "sampleSize": {
      "type": "number"
    },
    "state": {
      "type": "string"
    },
    "trendDirection": {
      "enum": [
        "up",
        "flat",
        "down",
        "insufficient_data"
      ],
      "type": "string"
    },
    "verifyNext": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "step": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "step",
          "url"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "kind",
    "generatedAt",
    "query",
    "comps",
    "sampleSize",
    "trendDirection",
    "componentStatus",
    "provenance",
    "caveats",
    "verifyNext"
  ],
  "type": "object"
}