List the H3 cells of the flagged purchases of a place

curl --request GET \
  --url https://api.investorlift.com/v3/deals/cells \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.investorlift.com/v3/deals/cells', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "res": 7,
    "cells": [
      {
        "cell": "8729b6da0ffffff",
        "n": 1,
        "n_repeat": 0,
        "n_resold": 0,
        "n_registry": 1,
        "n_buyers": 1
      },
      {
        "cell": "8729b6da4ffffff",
        "n": 30,
        "n_repeat": 8,
        "n_resold": 2,
        "n_registry": 20,
        "n_buyers": 29
      },
      {
        "cell": "8729b6da6ffffff",
        "n": 52,
        "n_repeat": 24,
        "n_resold": 4,
        "n_registry": 31,
        "n_buyers": 52
      },
      {
        "cell": "8729b6db4ffffff",
        "n": 3,
        "n_repeat": 2,
        "n_resold": 1,
        "n_registry": 3,
        "n_buyers": 3
      },
      {
        "cell": "8748eba4affffff",
        "n": 2,
        "n_repeat": 1,
        "n_resold": 2,
        "n_registry": 1,
        "n_buyers": 2
      },
      {
        "cell": "8748eba58ffffff",
        "n": 13,
        "n_repeat": 6,
        "n_resold": 2,
        "n_registry": 11,
        "n_buyers": 13
      },
      {
        "cell": "8748eba59ffffff",
        "n": 31,
        "n_repeat": 15,
        "n_resold": 7,
        "n_registry": 22,
        "n_buyers": 29
      },
      {
        "cell": "8748eba5affffff",
        "n": 6,
        "n_repeat": 4,
        "n_resold": 1,
        "n_registry": 2,
        "n_buyers": 6
      },
      {
        "cell": "8748eba5bffffff",
        "n": 76,
        "n_repeat": 38,
        "n_resold": 11,
        "n_registry": 55,
        "n_buyers": 70
      }
    ]
  },
  "meta": {
    "generated_at": "2026-09-23T01:48:15.736Z",
    "geometry": {
      "kind": "place",
      "lat": null,
      "lng": null,
      "radius_miles": null,
      "bbox": null,
      "property_id": null,
      "address": null,
      "zip": [
        "85251"
      ],
      "city": null
    },
    "coverage": [],
    "terms": "Data: Investorlift Data Services. Public-record and MLS listing data licensed through BatchData; municipal short-term rental registries; Investorlift marketplace records. Attribution and data-use terms: https://developers.investorlift.com/guides/terms",
    "build": {
      "states": [
        {
          "state": "AZ",
          "build_id": null,
          "built_at": "2026-09-22T13:41:32.949Z",
          "published_at": "2026-09-23T01:02:16.717Z",
          "run_id": 1790123752
        }
      ]
    }
  }
}

GET

deals

cells

List the H3 cells of the flagged purchases of a place

curl --request GET \
  --url https://api.investorlift.com/v3/deals/cells \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.investorlift.com/v3/deals/cells', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "res": 7,
    "cells": [
      {
        "cell": "8729b6da0ffffff",
        "n": 1,
        "n_repeat": 0,
        "n_resold": 0,
        "n_registry": 1,
        "n_buyers": 1
      },
      {
        "cell": "8729b6da4ffffff",
        "n": 30,
        "n_repeat": 8,
        "n_resold": 2,
        "n_registry": 20,
        "n_buyers": 29
      },
      {
        "cell": "8729b6da6ffffff",
        "n": 52,
        "n_repeat": 24,
        "n_resold": 4,
        "n_registry": 31,
        "n_buyers": 52
      },
      {
        "cell": "8729b6db4ffffff",
        "n": 3,
        "n_repeat": 2,
        "n_resold": 1,
        "n_registry": 3,
        "n_buyers": 3
      },
      {
        "cell": "8748eba4affffff",
        "n": 2,
        "n_repeat": 1,
        "n_resold": 2,
        "n_registry": 1,
        "n_buyers": 2
      },
      {
        "cell": "8748eba58ffffff",
        "n": 13,
        "n_repeat": 6,
        "n_resold": 2,
        "n_registry": 11,
        "n_buyers": 13
      },
      {
        "cell": "8748eba59ffffff",
        "n": 31,
        "n_repeat": 15,
        "n_resold": 7,
        "n_registry": 22,
        "n_buyers": 29
      },
      {
        "cell": "8748eba5affffff",
        "n": 6,
        "n_repeat": 4,
        "n_resold": 1,
        "n_registry": 2,
        "n_buyers": 6
      },
      {
        "cell": "8748eba5bffffff",
        "n": 76,
        "n_repeat": 38,
        "n_resold": 11,
        "n_registry": 55,
        "n_buyers": 70
      }
    ]
  },
  "meta": {
    "generated_at": "2026-09-23T01:48:15.736Z",
    "geometry": {
      "kind": "place",
      "lat": null,
      "lng": null,
      "radius_miles": null,
      "bbox": null,
      "property_id": null,
      "address": null,
      "zip": [
        "85251"
      ],
      "city": null
    },
    "coverage": [],
    "terms": "Data: Investorlift Data Services. Public-record and MLS listing data licensed through BatchData; municipal short-term rental registries; Investorlift marketplace records. Attribution and data-use terms: https://developers.investorlift.com/guides/terms",
    "build": {
      "states": [
        {
          "state": "AZ",
          "build_id": null,
          "built_at": "2026-09-22T13:41:32.949Z",
          "published_at": "2026-09-23T01:02:16.717Z",
          "run_id": 1790123752
        }
      ]
    }
  }
}

This route serves the lean set under /v3/deals/cells. See The lean dataset for the tier rules.

Authorizations

Authorization

string

header

required

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

Query Parameters

lat

number

Point latitude, with lng: the centre of a radius. One of lat with lng, property_id, zip, or bbox is required.

Required range: -90 <= x <= 90

lng

number

Point longitude, with lat.

Required range: -180 <= x <= 180

radius_miles

number

The radius in miles around the point or the parcel, 0.25 to 20 (default 1).

Required range: 0.25 <= x <= 20

property_id

string

A parcel of the place index: the centre of a radius. The API resolves it to its point.

Pattern: ^[0-9a-f]{32}$

zip

string[]

A place as a list of 5-digit ZIPs (comma list or repeated key), at most 20.

Minimum array length: 1

Pattern: ^\d{5}$

bbox

string

Viewport as west,south,east,north (WGS84 degrees), the diagonal at most 40 mi.

from

string<date>

Keep deals dated on or after this date, YYYY-MM-DD.

string<date>

Keep deals dated on or before this date, YYYY-MM-DD.

price_min

integer

Keep deals priced at or above this, whole US dollars. An unpriced deal leaves.

Required range: 0 <= x <= 9007199254740991

price_max

integer

Keep deals priced at or below this, whole US dollars. An unpriced deal leaves.

Required range: 0 <= x <= 9007199254740991

segment

string[]

Keep these segments of the parcel (comma list or repeated key): SFR, CONDO_TH or OTHER.

Minimum array length: 1

Required string length: 1 - 20

doc_class

string[]

Keep these classes of the deed (comma list or repeated key): ECONOMIC, DISTRESSED or another class of the build.

Minimum array length: 1

Required string length: 1 - 20

tag

string[]

Keep deals whose buyer carries any of these tags (comma list or repeated key), for example investor, ibuyer, builder, bank.

Minimum array length: 1

Required string length: 1 - 40

buyer

enum<string>

Keep the deals of one buyer kind. Default: both.

Available options:

registry,

deed_name

repeat

enum<string>

True keeps the deals of a buyer that bought another parcel in the 12 months before, false the others.

Available options:

true,

false

resold

enum<string>

True keeps the deals whose parcel was sold again within 12 months, false the others.

Available options:

true,

false

clean

enum<string>

True keeps the clean purchases alone, the deeds with no hard reason.

Available options:

true,

false

auction

enum<string>

True keeps the purchases at a foreclosure auction: a trustee sale or a sheriff sale that passed the five tests of the build. False keeps the others.

Available options:

true,

false

reo

enum<string>

True keeps the purchases from a lender, a servicer or an agency after a take-back (REO). False keeps the others.

Available options:

true,

false

res

enum<string>

default:8

The H3 resolution of the cells: 7 (about 5 square km each) or 8 (about 0.7 square km). Default 8.

Available options:

7,

8

Response

The flagged purchases of the place as H3 cells.

data

object

required

The flagged purchases of the place as H3 cells with counts, for a map at a low zoom.

Show child attributes

Overview

Objects

Buyers

Deals

Investors

Properties

Lenders

Listing agents

Investorlift listings

Dataset and coverage

By contract

Lean set (/v3)

Deals

Buyers

Investors

Properties

Listing agents

MLS listings

Investorlift listings

Lenders

By contract

Dataset and coverage

Lean set

List the H3 cells of the flagged purchases of a place

Authorizations

Query Parameters

Response