Skip to main content
GET
Rank nearby investors as buyers for a property

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
kind
enum<string>[]

Deal kinds to keep (comma list or repeated key). Default: every kind.

Minimum array length: 1

What occurred on the deal. flip: bought, fixed and resold within about a year at a profit-shaped margin; wholesale: bought and resold in under 30 days, or a chain resale or round trip within 90 (a double close); hold: bought and still owned at data_end, a confirmed holding or an un-resold purchase; long_hold: held over a year, then sold (a landlord exit); other: an investor resale that is not a clean flip. Reasons: a loss, a thin margin, a builder's new home resold, an iBuyer resale, or a chain resale of 3 to 12 months; build: a registered investor bought a lot or teardown, built a house on it during the hold, then sold. A builder's finished home bought and resold is other. On data built after 2026-09-17 the kind keeps only a single-family parcel held over 90 days, its house complete by the sale year. A market built on or before 2026-09-17 (meta.coverage[].loaded_at) counts every lot-to-build resale by a registered investor as a build until its next build.

Available options:
flip,
wholesale,
hold,
long_hold,
other,
build
​
price_min
integer

Minimum bought price, inclusive, integer dollars. When you set price_min or price_max, the API drops null-priced rows unless include_unpriced=true.

Required range: 0 <= x <= 9007199254740991
​
price_max
integer

Maximum bought price, inclusive, integer dollars.

Required range: 0 <= x <= 9007199254740991
​
bought_after
string

Keep deals bought on or after this date. When you set bought_after or bought_before, the API drops null-date rows unless include_undated=true.

​
bought_before
string

Keep deals bought on or before this date.

​
sold_after
string

Resold deals only: sold on or after this date.

​
sold_before
string

Resold deals only: sold on or before this date.

​
segment
enum<string>[]

Parcel segments to keep. Default: every segment.

Minimum array length: 1

Parcel segment: SFR, CONDO_TH (condo or townhouse) or OTHER, a mixed bucket of manufactured, multi-family, land and commercial parcels.

Available options:
SFR,
CONDO_TH,
OTHER
​
beds_min
integer

Minimum bedrooms, inclusive.

Required range: 0 <= x <= 50
​
sqft_min
integer

Minimum living area in square feet, inclusive, 0 to 1,000,000.

Required range: 0 <= x <= 1000000
​
sqft_max
integer

Maximum living area in square feet, inclusive, 0 to 1,000,000.

Required range: 0 <= x <= 1000000
​
investor_kind
enum<string>[]

Keep investors that carry at least one listed kind. The check reads any of their kinds[], never the primary kind. Default: every kind. Buyers without an investor id pass unless registered_only=true.

Minimum array length: 1

Investor kind, the primary one of kinds[] (an investor can carry several), for display only. FLIPPER: buys, renovates and resells. WHOLESALER: buys to resell quickly, often through a double close. LANDLORD: buys and holds rentals. BUILDER: builds on lots it buys. IBUYER: Opendoor, Offerpad or Zillow.

Available options:
FLIPPER,
WHOLESALER,
LANDLORD,
BUILDER,
IBUYER
​
investor_kind_exclude
enum<string>[]

Drop investors that carry any listed kind. The API checks kinds[] after investor_kind. investor_kind_exclude=WHOLESALER removes investors who also wholesale.

Minimum array length: 1

Investor kind, the primary one of kinds[] (an investor can carry several), for display only. FLIPPER: buys, renovates and resells. WHOLESALER: buys to resell quickly, often through a double close. LANDLORD: buys and holds rentals. BUILDER: builds on lots it buys. IBUYER: Opendoor, Offerpad or Zillow.

Available options:
FLIPPER,
WHOLESALER,
LANDLORD,
BUILDER,
IBUYER
​
investor_confidence_min
enum<string>

Minimum registry confidence in the investor kind: STRONG, PROBABLE or WEAK (WEAK admits everything).

Available options:
STRONG,
PROBABLE,
WEAK
​
scale
enum<string>[]

Scale tiers to keep. Default: every tier except institutional. An explicit list replaces the default entirely. scale=institutional alone returns only institutional. scale=individual,small,mid,large,institutional returns everyone.

Minimum array length: 1

Investor scale: individual (one person, no entity), small (fewer than 10 investment deals), mid (10 to 99), large (100 to 999) or institutional. An institutional investor is an iBuyer, a production builder, a bulk landlord with 500 or more holdings, or a known brand from a list. The registry counts the deals inside the area loaded for the market (meta.coverage[].universe_kind), so in a ZIP market the tier is a floor.

Available options:
individual,
small,
mid,
large,
institutional
​
include_public
enum<string>

Include public-body investors (counties, cities, housing authorities) and their deals. Default false: every list endpoint hides them.

Available options:
true,
false
​
include_unpriced
enum<string>

Keep null-priced rows when you set price_min or price_max (default false).

Available options:
true,
false
​
include_undated
enum<string>

Keep null-date rows when you set bought_after or bought_before (default false).

Available options:
true,
false
​
active_within_months
integer

Keep investors whose last purchase is at most this many months before data_end (data_end minus last_bought_on). Sales and transfers do not count. No default.

Required range: 1 <= x <= 600
​
investor_deals_min
integer

Minimum purchase events of that investor inside the geometry, 1 to 1,000,000. The API applies it after the other filters.

Required range: 1 <= x <= 1000000
​
holds_min
integer

Investor filter: keep investors who hold at least this many parcels across the whole market at the deed data end (meta.coverage[].data_end). The count is the investor's n_holds: confirmed holdings plus un-resold purchases inside the area loaded for the market, not the holdings inside the geometry. Range 0 to 1,000,000, inclusive. For example, holds_min=20 keeps the larger portfolios. Buyers without an investor id pass unless registered_only=true.

Required range: 0 <= x <= 1000000
​
holds_max
integer

Investor filter: keep investors who hold at most this many parcels across the whole market at the deed data end (n_holds). Range 0 to 1,000,000, inclusive. holds_max=0 keeps the investors that hold nothing. Beside holds_min the pair is a band. Buyers without an investor id pass unless registered_only=true.

Required range: 0 <= x <= 1000000
​
buys_wholesale
enum<string>

Investor filter: at least one bought-from-wholesaler deal in the 36 months before data_end.

Available options:
true,
false
​
buys_at_auction
enum<string>

Investor filter: true keeps investors who bought at least one house at a foreclosure auction in the 24 months before data_end. A foreclosure auction is a trustee's sale or an Arizona sheriff's sale, and the filter reads investor.auction.is_active_auction_buyer. These buyers pay cash within a day and buy without an inspection. False keeps registered investors who did not. Buyers without an investor id pass unless registered_only=true. The API answers 422 auction_unavailable in a market that does not publish its auction counts (meta.coverage[].auction_counted false).

Available options:
true,
false
​
buys_reo
enum<string>

Investor filter: true keeps investors who bought at least one house from a lender, servicer or agency after a foreclosure. The window is the 24 months before data_end, and the filter reads investor.auction.is_active_reo_buyer. A bank-owned (REO) sale gave the buyer weeks, an inspection and the option to finance: the weaker cash signal beside buys_at_auction. False keeps registered investors who did not, and buys_at_auction=true&buys_reo=false is the cash-only set. Buyers without an investor id pass unless registered_only=true. The API answers 422 auction_unavailable where the market does not publish its auction counts.

Available options:
true,
false
​
bought_auction_kind
enum<string>[]

Deal filter: keep deals whose purchase deed was a third-party auction purchase of one of the listed kinds (comma list or repeated key). For example, bought_auction_kind=TRUSTEE_SALE keeps houses bought at a foreclosure sale. The API drops deals bought any other way and deals without a buy deed. The API answers 422 auction_unavailable where the market does not publish its auction counts.

Minimum array length: 1

The kind of auction the purchase deed records: TRUSTEE_SALE and SHERIFF_SALE count toward buys_at_auction, and the API shows the other three but never counts them. TRUSTEE_SALE: a lender's foreclosure sale by the trustee, cash and final on the day, without redemption. In Arizona the buyer pays a $10,000 deposit and the full bid by 5 pm the next business day. In Texas it is the first-Tuesday courthouse sale, in Washington the Friday sale at the county's designated place under RCW 61.24. SHERIFF_SALE: a judicial sale under court order. In Arizona it is an HOA or judgment-lien sale, cash but subject to the first mortgage and to a 30-day or 6-month redemption. In Washington it is a judicial mortgage foreclosure or lien sale under RCW 6.21, with an 8-month or 1-year redemption. In Washington the sale is subject to the senior lien only when it is a lien sale. HOA_TRUSTEE_SALE: a Texas homeowners association foreclosure recorded as a trustee's deed, cash, subject to the first lien and to a 180-day redemption. TAX_SALE: a Texas constable or taxing-unit tax sale, cash, with a 180-day or 2-year redemption. In Washington it is the county treasurer's deed after the tax foreclosure judgment, with no redemption after the sale. TAX_LIEN_DEED: an Arizona treasurer's deed to a tax-lien holder, mostly vacant land, not an auction of the house.

Available options:
TRUSTEE_SALE,
SHERIFF_SALE,
HOA_TRUSTEE_SALE,
TAX_SALE,
TAX_LIEN_DEED
​
bought_from_wholesaler
enum<string>

Deal filter: bought through a documented double close from a wholesaler, or from a known wholesaler. Assignments leave no deed, so absence is not evidence.

Available options:
true,
false
​
bought_distressed
enum<string>

Deal filter: the buy leg was a distressed sale. That is a foreclosure, trustee, sheriff or tax instrument, a deed in lieu, or a deed the feed flags as REO. It is wider than bought_auction_kind, which keeps only third-party auction purchases.

Available options:
true,
false
​
registered_only
enum<string>

Keep only rows whose buyer carries an investor id (investor.id is not null).

Available options:
true,
false
​
buyer_status
enum<string>[]

Buyer statuses to keep.

Minimum array length: 1

The buyer's standing in the registry: registered (has an investor id), unclassified, excluded or unknown (the deed names no buyer). Unclassified: a named buyer the registry did not classify as an investor, usually a household. Excluded: a named buyer the registry deliberately left out. Those are custodian trusts, relocation companies, auction houses and ambiguous surnames.

Available options:
registered,
unclassified,
excluded,
unknown
​
str_operator
enum<string>

Investor filter: true keeps investors that hold at least one parcel with a business-use short-term-rental licence attributed to them. That is the str roll-up's n_holdings at 1 or more. False keeps investors with none. Buyers without an investor id pass unless registered_only=true. The API answers 422 str_unavailable when a market in play has no short-term rental tables (meta.coverage[].str_as_of null).

Available options:
true,
false
​
str_holdings_min
integer

Investor filter: at least this many of the investor's holdings carry a business-use short-term-rental licence attributed to them (the str roll-up's n_holdings), 1 or more. Buyers without an investor id pass unless registered_only=true. The API answers 422 str_unavailable when a market in play has no short-term rental tables.

Required range: 1 <= x <= 100000
​
financed_by
string

Investor filter: keep investors with at least one recorded loan from this lender, as the main borrower of the mortgage or the open lien. The value is a lender id, len_ followed by 12 hex characters, for example len_d2028f0766fc from GET /v1/lenders/search. The match is investor_id on the lender's loan rows. The count is a floor: the recorded history sees about one loan in five. Buyers without an investor id pass unless registered_only=true. The API answers 422 lenders_unavailable when a market in play has no lender registry with the borrower match (meta.coverage[].lenders null or borrowers_measured false).

Pattern: ^len_[0-9a-f]{12}$
​
uses_private_lender
enum<string>

Investor filter: true keeps investors with a loan from a private lender, recorded in the 24 months before the lender registry's slice date (meta.coverage[].lenders.as_of). A private lender is a hard-money lender by name or behaviour (is_hard_money) or an investor lender by behaviour (is_investor_lender). A lender whose class reads INDIVIDUAL or PRIVATE also counts as private. False keeps registered investors with none such, and the result is a floor of a partial feed. Buyers without an investor id pass unless registered_only=true. The API answers 422 lenders_unavailable when a market in play has no lender registry with the borrower match.

Available options:
true,
false
​
investor_id
string

Scope the rows to one buyer (the drawer's "Activity here"). The API follows an old id from an earlier data refresh to the investor that superseded it and echoes the old id in meta.resolved_from. A retired id is 410 gone.

Pattern: ^inv_[0-9a-f]{12}$
​
deal_id
string

Scope the rows to one deal.

Pattern: ^deal_[0-9a-f]{32}$
​
lat
number

Point latitude (with lng). With radius_miles it is the search geometry. With bbox it is the reference point only.

Required range: -90 <= x <= 90
​
lng
number

Point longitude (with lat).

Required range: -180 <= x <= 180
​
radius_miles
number

Search radius in miles around the point or around the centre of the property_id parcel, 0.25 to 20 (default 2). Not allowed with bbox.

Required range: 0.25 <= x <= 20
​
bbox
string

Viewport as west,south,east,north (WGS84 degrees). West must be less than east, south less than north, and the diagonal at most 40 mi. It must intersect a loaded market's coverage bbox (422 outside_coverage otherwise). It can carry lat + lng (without radius_miles) as the reference point for distances and sort=distance.

​
property_id
string

Parcel geometry: search around the centre of that parcel, with radius_miles. Not allowed with lat, lng or bbox.

Pattern: ^prop_[0-9a-f]{32}$
​
zip
string[]

Place geometry: the parcels of these 5-digit ZIP codes, as a comma list or a repeated key, up to 50. On the deal and investor routes the Free and Starter plans take exactly one ZIP, and more is 403 plan_limit. You can add lat + lng as the reference point for distances. Not with radius_miles, bbox, property_id or city. A ZIP that no parcel of a loaded market carries is 422 outside_coverage (zips_unknown in the body).

Required array length: 1 - 50 elements
Pattern: ^\d{5}$
​
city
string

Place geometry: the parcels whose postal city is this one, as the county records it ("Scottsdale"). Case does not matter: the API compares the value folded upper case. Never the short-term rental jurisdiction (meta.coverage[].str.jurisdictions[]). You can add lat + lng as the reference point, but not radius_miles, bbox, property_id or zip. On the deal and investor routes of the Free and Starter plans a city-wide search is 403 plan_limit. A city that no parcel of a loaded market carries is 422 outside_coverage.

Required string length: 1 - 100
​
subject_asking_price
integer

The contract or asking price of the subject deal, whole dollars, for example 250000. Send it only when the deal has an asking price. It feeds the price_fit factor and never filters deals.

Required range: 1 <= x <= 9007199254740991
​
subject_arv
integer

After-repair value of the subject, whole dollars, for example 560000. Send it only when it is known and above 0. Without an asking price it drives price_fit through the buy-to-resale ratio of the investor, or else the ratio of the metro (meta.coverage[].metro_buy_to_resale_ratio). It also enables the resale_fit reason (weight 0 by default).

Required range: 1 <= x <= 9007199254740991
​
subject_condition
enum<string>

Condition of the subject property, the Investorlift enum. TURN_KEY: move-in ready, where landlords and iBuyers fit best. LIGHT_REHAB: cosmetic work, for flippers and landlords. MAJOR_REHAB and FULL_GUT: heavy work, flippers first and builders next. TEAR_DOWN: a lot, builders first. It drives the strategy factor: if you omit it, the API drops that factor.

Available options:
TURN_KEY,
LIGHT_REHAB,
MAJOR_REHAB,
FULL_GUT,
TEAR_DOWN
​
subject_segment
enum<string>

Segment of the subject property: SFR, CONDO_TH (condo or townhouse) or OTHER. OTHER is a mixed bucket: manufactured, multi-family, land and commercial. The subject segment drives the segment factor, the share of the deals of the investor in this segment. It defaults from the parcel when the geometry is property_id. Otherwise omit it and the API drops the factor. Investorlift mapping: single_family maps to SFR, condo and townhouse map to CONDO_TH, and everything else maps to OTHER.

Available options:
SFR,
CONDO_TH,
OTHER
​
subject_beds
integer

Bedrooms of the subject, for example 3. It defaults from the parcel when the geometry is property_id. The API accepts and echoes it for forward compatibility and does not score it in this version.

Required range: 0 <= x <= 50
​
subject_sqft
integer

Living area of the subject in square feet, for example 1650. It defaults from the parcel when the geometry is property_id. The API accepts and echoes it for forward compatibility and does not score it in this version.

Required range: 1 <= x <= 9007199254740991
​
w_proximity
number

Weight of the proximity factor, 0 to 1 (default 0.3). Proximity: how many separate purchase days they had near the subject and how close.

Required range: 0 <= x <= 1
​
w_recency
number

Weight of the recency factor, 0 to 1 (default 0.25). Recency: how close to the deed data end (meta.coverage[].data_end) they last bought, and how often they buy.

Required range: 0 <= x <= 1
​
w_price_fit
number

Weight of the price_fit factor, 0 to 1 (default 0.2). Price fit: if the subject price sits inside what they usually pay. Needs subject_asking_price or subject_arv.

Required range: 0 <= x <= 1
​
w_strategy
number

Weight of the strategy factor, 0 to 1 (default 0.1). Strategy: if their kinds suit the subject condition. Needs subject_condition.

Required range: 0 <= x <= 1
​
w_segment
number

Weight of the segment factor, 0 to 1 (default 0.05). Segment: the share of their deals in the subject segment. Needs subject_segment or property_id.

Required range: 0 <= x <= 1
​
w_wholesale_buyer
number

Weight of the wholesale_buyer factor, 0 to 1 (default 0.1). Wholesale buyer: how many documented wholesale purchases they made in the 5 years ending on the deed data end (meta.coverage[].data_end).

Required range: 0 <= x <= 1
​
w_resale_fit
number

Weight of the resale_fit factor, 0 to 1 (default 0). Resale fit: the subject ARV against their median flip resale. Needs subject_arv. The default is 0, so the API shows the reason without moving the score.

Required range: 0 <= x <= 1
​
w_activity
number

Weight of the activity signal, 0 to 1 (default 0: off), not part of reasons[] or meta.weights. The API multiplies the score by the probability that the operator buys in the 180 days after the data end (buyer_signal.activity_p_180), raised to this power. A power of 1 ranks by expected purchases, 0.5 softens the effect, and 0 leaves the ranking as it is. Any change starts a new ranking and invalidates the cursor, and the activity_multiplier of the row shows what the signal did. An investor with no probability, a dormant operator or one with no signal row, scores as 0.034, the measured dormant re-activation rate. In the Phoenix measurement 3.4% of dormant operators bought again within 180 days.

Required range: 0 <= x <= 1
​
include_unregistered
enum<string>

Add summary.unregistered[]: the id-less buyers inside the geometry, households and unclassified names that bought here. The API scores them on proximity and recency only. A lead list, not a ranking: most have one deal.

Available options:
true,
false
​
include_excluded
enum<string>

With include_unregistered=true, also list the excluded buyers: custodian trusts, relocation companies, auction houses and ambiguous surnames. Default false.

Available options:
true,
false
​
limit
integer
default:100

Page size, 1-200 (default 100).

Required range: 1 <= x <= 200
​
cursor
string

Opaque cursor from page.next_cursor of the previous page. A change of query, sort, weights or data version invalidates it (400 invalid_cursor). Then restart from page 1.

Required string length: 1 - 4096

Response

Ranked buyers, best first, with reasons; summary for the whole area; meta.weights and meta.reference_point.

Ranked buyers, best first, with reasons; summary for the whole area; meta.weights and meta.reference_point.

​
data
object[]
required

The rows of this page.

​
page
object
required

Pagination: the page size, the rows returned and the cursor for the next page. Paged lists carry no total. The summary block does.

​
meta
object
required

Response metadata: when the API produced it, which markets it covers, and how fresh they are.

​
summary
object
required

Counts for the whole geometry, not only the page, plus the unregistered tail when you ask for it.