Read the comparable sales around a parcel

curl --request GET \
  --url https://api.investorlift.com/v1/properties/{property_id}/comps \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.investorlift.com/v1/properties/{property_id}/comps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.investorlift.com/v1/properties/{property_id}/comps"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": {
    "subject": {
      "property_id": "<string>",
      "market": "<string>",
      "address_short": "<string>",
      "city": "<string>",
      "zip": "<string>",
      "latitude": 0,
      "longitude": 0,
      "bedrooms": 0,
      "bathrooms": 123,
      "sqft": 0,
      "year_built": 0,
      "last_sale": {
        "sold_on": "<string>",
        "sold_price": 0
      }
    },
    "comps": [
      {
        "property_id": "<string>",
        "market": "<string>",
        "address_short": "<string>",
        "city": "<string>",
        "zip": "<string>",
        "distance_miles": 123,
        "sold_on": "<string>",
        "sold_price": 0,
        "price_per_sqft": 123,
        "bedrooms": 0,
        "bathrooms": 123,
        "sqft": 0,
        "year_built": 0,
        "source": "DEED",
        "days_on_market": 0,
        "list_price": 0,
        "cash_sale_proxy": true,
        "last_sale_lender": "<string>",
        "deal": {
          "id": "<string>",
          "kind": "flip",
          "investor_id": "<string>",
          "gross_profit": 0,
          "hold_days": 0
        },
        "similarity": 0.5
      }
    ],
    "summary": {
      "n": 0,
      "n_deed": 0,
      "n_mls": 0,
      "median_price": 123,
      "median_price_per_sqft": 123,
      "price_per_sqft_value": 123,
      "min_price": 123,
      "max_price": 123,
      "radius_miles": 123,
      "window_start": "<string>",
      "window_end": "<string>",
      "sources": [
        "DEED"
      ],
      "tolerances": {
        "bedrooms": 0,
        "sqft_pct": 0,
        "year_built": 0
      }
    }
  },
  "meta": {
    "generated_at": "<string>",
    "coverage": [
      {
        "market": "<string>",
        "state": "<string>",
        "counties": [
          {
            "fips": "<string>",
            "name": "<string>",
            "data_end": "<string>"
          }
        ],
        "bbox": [
          0,
          0,
          0,
          0
        ],
        "data_end": "<string>",
        "build_run_id": 0,
        "registry_run": 0,
        "registry_version": "<string>",
        "dataset_version": 0,
        "loaded_at": "<string>",
        "metro_buy_to_resale_ratio": 123,
        "universe_kind": "zip",
        "universe_zips": [
          "<string>"
        ],
        "point_tolerance_miles": 123,
        "n_parcels": 0,
        "listings_data_end": "<string>",
        "agents_data_end": "<string>",
        "wholesale_as_of": "<string>",
        "str_as_of": "<string>",
        "str": {
          "jurisdictions": [
            {
              "name": "<string>",
              "regime": "REQUIRED",
              "coverage_reason": "LOADED_SERVED",
              "served": true,
              "snapshot_only": true,
              "licence_start": "<string>",
              "snapshot_date": "<string>",
              "feed_stale": true,
              "sources": [
                {
                  "source": "<string>",
                  "snapshot_date": "<string>",
                  "stale": true
                }
              ],
              "n_licensed": 0,
              "n_pending": 0,
              "n_expired": 0,
              "n_advertised": 0,
              "share_unmatched": 123,
              "share_assumed": 123
            }
          ]
        },
        "auction_counted": true,
        "parcel_as_of": "<string>",
        "address_as_of": "<string>",
        "parcel": {
          "parcel_as_of": "<string>",
          "n_parcels": 0,
          "sale_mortgage_measured": true,
          "financing": {
            "as_of": "<string>",
            "dated": true,
            "dated_reason": "<string>",
            "n_parcels": 0,
            "n_with_open_lien": 0,
            "n_free_and_clear": 0,
            "n_avm": 0,
            "n_involuntary": 0,
            "n_lenders": 0
          },
          "permits": {
            "as_of": "<string>",
            "n_permits": 0,
            "n_parcels": 0,
            "n_unmatched": 0,
            "jurisdictions": [
              {
                "jurisdiction": "<string>",
                "n_permits": 0,
                "last_issue_date": "<string>",
                "windows_measured": true
              }
            ]
          },
          "owner_profile": {
            "as_of": "<string>",
            "n_parcels": 0,
            "n_multi": 0,
            "n_portfolio_5": 0
          },
          "history": {
            "first_week": "<string>",
            "last_week": "<string>",
            "zips": [
              "<string>"
            ],
            "n_parcels": 0,
            "n_events": 0,
            "n_weeks": 0,
            "domains": {}
          }
        },
        "lenders": {
          "as_of": "<string>",
          "recordings_through": "<string>",
          "counties": [
            "<string>"
          ],
          "history_capture_share": 123,
          "n_lender_ids": 0,
          "purchase_measured": true,
          "investor_lending_measured": true,
          "flips_measured": true,
          "borrowers_measured": true,
          "takebacks_measured": true,
          "counties_measured": true,
          "dated": true,
          "n_parcels_uncovered": 0
        }
      }
    ],
    "terms": "<string>",
    "weights": {},
    "reference_point": {
      "lat": 0,
      "lng": 0
    },
    "geometry": {
      "kind": "radius",
      "lat": 0,
      "lng": 0,
      "radius_miles": 123,
      "bbox": {
        "[0]": 0,
        "[1]": 0,
        "[2]": 0,
        "[3]": 0
      },
      "property_id": "<string>",
      "zip": [
        "<string>"
      ],
      "city": "<string>"
    },
    "resolved_from": [
      "<string>"
    ],
    "dated": [
      {
        "block": "valuation",
        "as_of": "<string>",
        "reason": "<string>"
      }
    ]
  }
}

Properties

Read the comparable sales around a parcel

The comparable sales around one parcel, most similar first, plus the medians and an indicative price per square foot. A comp is a priced sale in the radius and the window on a parcel within the subject’s bedroom, size and age tolerances. One per parcel, from the deed registry (DEED) and the SOLD listings where published (MLS), each with the investor exit the deal registry records.

For raw parcels with your own filters use the parcel search. For investor deals alone, the deal scan.

How a comp is chosen and ranked.

GET

properties

{property_id}

comps

Read the comparable sales around a parcel

curl --request GET \
  --url https://api.investorlift.com/v1/properties/{property_id}/comps \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.investorlift.com/v1/properties/{property_id}/comps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.investorlift.com/v1/properties/{property_id}/comps"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": {
    "subject": {
      "property_id": "<string>",
      "market": "<string>",
      "address_short": "<string>",
      "city": "<string>",
      "zip": "<string>",
      "latitude": 0,
      "longitude": 0,
      "bedrooms": 0,
      "bathrooms": 123,
      "sqft": 0,
      "year_built": 0,
      "last_sale": {
        "sold_on": "<string>",
        "sold_price": 0
      }
    },
    "comps": [
      {
        "property_id": "<string>",
        "market": "<string>",
        "address_short": "<string>",
        "city": "<string>",
        "zip": "<string>",
        "distance_miles": 123,
        "sold_on": "<string>",
        "sold_price": 0,
        "price_per_sqft": 123,
        "bedrooms": 0,
        "bathrooms": 123,
        "sqft": 0,
        "year_built": 0,
        "source": "DEED",
        "days_on_market": 0,
        "list_price": 0,
        "cash_sale_proxy": true,
        "last_sale_lender": "<string>",
        "deal": {
          "id": "<string>",
          "kind": "flip",
          "investor_id": "<string>",
          "gross_profit": 0,
          "hold_days": 0
        },
        "similarity": 0.5
      }
    ],
    "summary": {
      "n": 0,
      "n_deed": 0,
      "n_mls": 0,
      "median_price": 123,
      "median_price_per_sqft": 123,
      "price_per_sqft_value": 123,
      "min_price": 123,
      "max_price": 123,
      "radius_miles": 123,
      "window_start": "<string>",
      "window_end": "<string>",
      "sources": [
        "DEED"
      ],
      "tolerances": {
        "bedrooms": 0,
        "sqft_pct": 0,
        "year_built": 0
      }
    }
  },
  "meta": {
    "generated_at": "<string>",
    "coverage": [
      {
        "market": "<string>",
        "state": "<string>",
        "counties": [
          {
            "fips": "<string>",
            "name": "<string>",
            "data_end": "<string>"
          }
        ],
        "bbox": [
          0,
          0,
          0,
          0
        ],
        "data_end": "<string>",
        "build_run_id": 0,
        "registry_run": 0,
        "registry_version": "<string>",
        "dataset_version": 0,
        "loaded_at": "<string>",
        "metro_buy_to_resale_ratio": 123,
        "universe_kind": "zip",
        "universe_zips": [
          "<string>"
        ],
        "point_tolerance_miles": 123,
        "n_parcels": 0,
        "listings_data_end": "<string>",
        "agents_data_end": "<string>",
        "wholesale_as_of": "<string>",
        "str_as_of": "<string>",
        "str": {
          "jurisdictions": [
            {
              "name": "<string>",
              "regime": "REQUIRED",
              "coverage_reason": "LOADED_SERVED",
              "served": true,
              "snapshot_only": true,
              "licence_start": "<string>",
              "snapshot_date": "<string>",
              "feed_stale": true,
              "sources": [
                {
                  "source": "<string>",
                  "snapshot_date": "<string>",
                  "stale": true
                }
              ],
              "n_licensed": 0,
              "n_pending": 0,
              "n_expired": 0,
              "n_advertised": 0,
              "share_unmatched": 123,
              "share_assumed": 123
            }
          ]
        },
        "auction_counted": true,
        "parcel_as_of": "<string>",
        "address_as_of": "<string>",
        "parcel": {
          "parcel_as_of": "<string>",
          "n_parcels": 0,
          "sale_mortgage_measured": true,
          "financing": {
            "as_of": "<string>",
            "dated": true,
            "dated_reason": "<string>",
            "n_parcels": 0,
            "n_with_open_lien": 0,
            "n_free_and_clear": 0,
            "n_avm": 0,
            "n_involuntary": 0,
            "n_lenders": 0
          },
          "permits": {
            "as_of": "<string>",
            "n_permits": 0,
            "n_parcels": 0,
            "n_unmatched": 0,
            "jurisdictions": [
              {
                "jurisdiction": "<string>",
                "n_permits": 0,
                "last_issue_date": "<string>",
                "windows_measured": true
              }
            ]
          },
          "owner_profile": {
            "as_of": "<string>",
            "n_parcels": 0,
            "n_multi": 0,
            "n_portfolio_5": 0
          },
          "history": {
            "first_week": "<string>",
            "last_week": "<string>",
            "zips": [
              "<string>"
            ],
            "n_parcels": 0,
            "n_events": 0,
            "n_weeks": 0,
            "domains": {}
          }
        },
        "lenders": {
          "as_of": "<string>",
          "recordings_through": "<string>",
          "counties": [
            "<string>"
          ],
          "history_capture_share": 123,
          "n_lender_ids": 0,
          "purchase_measured": true,
          "investor_lending_measured": true,
          "flips_measured": true,
          "borrowers_measured": true,
          "takebacks_measured": true,
          "counties_measured": true,
          "dated": true,
          "n_parcels_uncovered": 0
        }
      }
    ],
    "terms": "<string>",
    "weights": {},
    "reference_point": {
      "lat": 0,
      "lng": 0
    },
    "geometry": {
      "kind": "radius",
      "lat": 0,
      "lng": 0,
      "radius_miles": 123,
      "bbox": {
        "[0]": 0,
        "[1]": 0,
        "[2]": 0,
        "[3]": 0
      },
      "property_id": "<string>",
      "zip": [
        "<string>"
      ],
      "city": "<string>"
    },
    "resolved_from": [
      "<string>"
    ],
    "dated": [
      {
        "block": "valuation",
        "as_of": "<string>",
        "reason": "<string>"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key.

Path Parameters

property_id

string

required

Parcel id, prop_<32 hex>, from /v1/properties/resolve or any deal's property.id. The prefix is part of the id (400 invalid_id otherwise).

Required string length: 1 - 64

Query Parameters

radius_miles

number

default:1

Radius around the subject in miles, 0.1 to 5 (default 1).

Required range: 0.1 <= x <= 5

days_back

integer

default:180

Sales in the last N days before the market's data_end, 30 to 1095 (default 180).

Required range: 30 <= x <= 1095

beds_tolerance

integer

default:1

Bedrooms either side of the subject's, 0 to 5 (default 1). The API skips it when the subject's bedrooms are unknown.

Required range: 0 <= x <= 5

sqft_pct

integer

default:20

Percent either side of the subject's sqft, 0 to 50 (default 20). The API skips it when the sqft is unknown.

Required range: 0 <= x <= 50

year_tolerance

integer

default:15

Years either side of the subject's year_built, 0 to 50 (default 15). The API skips it when the year_built is unknown.

Required range: 0 <= x <= 50

source

enum<string>

default:both

With deed, the registry's arm's-length last purchases. With mls, SOLD listing records, and 422 listings_unavailable where the market has none. With both, the default, one sale per parcel, and the MLS record wins within 45 days of the deed.

Available options:

deed,

mls,

both

limit

integer

default:20

Comps to return, 1 to 50 (default 20), most similar first. A plan cap below this applies.

Required range: 1 <= x <= 50

Response

The comparable sales of one parcel.

data

object

required

GET /v1/properties/{id}/comps: the subject, its comparable sales within the radius, the window and the tolerances, and the summary.

Show child attributes

Overview

Objects

Buyers

Deals

Investors

Properties

Lenders

Listing agents

Investorlift listings

Dataset and coverage

By contract

Deals

Buyers

Investors

Properties

Listing agents

Investorlift listings

Lenders

By contract

Dataset and coverage

Read the comparable sales around a parcel

Authorizations

Path Parameters

Query Parameters

Response