curl --request GET \
--url https://api.investorlift.com/v3/buyers/match \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/buyers/match', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/buyers/match"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"org_id": "AZ:L09606353",
"org_name": "ZAK VENTURES LLC",
"from_registry": true,
"n_like": 11,
"n_zip": 7,
"n_near": 12,
"n_near_12m": 5,
"last_like_date": "2026-09-01",
"last_near_date": "2026-09-01",
"nearest_miles": 0,
"median_like_price": 200000,
"price_p25_like": 186250,
"price_p75_like": 215000,
"n_deals_all": 226,
"n_entities": 39,
"company_like": null,
"is_active": true,
"days_since_last_purchase": 22,
"n_closings_as_buyer": 0,
"financing": {
"n_loans": 46,
"n_loans_24m": 5,
"n_lenders": 4,
"n_lenders_tagged_hard_money": 0,
"top_lender": {
"org_id": "AZ:name:FIRST FIDELITY BANK",
"org_name": "FIRST FIDELITY BANK",
"from_registry": false,
"tags": [
"bank",
"institution"
]
},
"last_loan_on": "2025-12-18",
"as_of": "2026-06-25"
}
},
{
"org_id": "AZ:name:OLYMPUS EQUITY",
"org_name": "OLYMPUS EQUITY LLC",
"from_registry": false,
"n_like": 3,
"n_zip": 3,
"n_near": 4,
"n_near_12m": 2,
"last_like_date": "2026-05-20",
"last_near_date": "2026-05-20",
"nearest_miles": 1.01,
"median_like_price": 231000,
"price_p25_like": 219000,
"price_p75_like": 231500,
"n_deals_all": null,
"n_entities": null,
"company_like": true,
"is_active": true,
"days_since_last_purchase": 126,
"n_closings_as_buyer": 2,
"financing": {
"n_loans": 0,
"n_loans_24m": 0,
"n_lenders": 0,
"n_lenders_tagged_hard_money": 0,
"top_lender": null,
"last_loan_on": null,
"as_of": "2026-06-25"
}
},
{
"org_id": "AZ:23140564",
"org_name": "ITZAE REAL ESTATE INVESTMENTS LLC",
"from_registry": true,
"n_like": 2,
"n_zip": 2,
"n_near": 2,
"n_near_12m": 2,
"last_like_date": "2026-09-04",
"last_near_date": "2026-09-04",
"nearest_miles": 0.48,
"median_like_price": 216000,
"price_p25_like": 208500,
"price_p75_like": 223500,
"n_deals_all": 3,
"n_entities": 1,
"company_like": null,
"is_active": true,
"days_since_last_purchase": 19,
"n_closings_as_buyer": 1,
"financing": {
"n_loans": 0,
"n_loans_24m": 0,
"n_lenders": 0,
"n_lenders_tagged_hard_money": 0,
"top_lender": null,
"last_loan_on": null,
"as_of": "2026-06-25"
}
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8bGVhbi1BWjE3OTIzNTgwNjktQ0ExNzkwMjE1MTkwLUZMMTc5MDI2MjY4Mi1UWDE3OTAyNDgyMTMiLCJxIjoiOGE3NDUyNGRmZjUwYWVjNWRlMGEyM2M4YTE1NjRkNTlmYjc2MDhiOTI2NjJmYmM4YTU0MGNkMWUwZjdjNTdiYyIsImsiOlsyLCIyMDI2LTA5LTA0IiwiQVo6MjMxNDA1NjQiXX0",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-10-18T21:38:34.282Z",
"reference_point": {
"lat": 33.499313,
"lng": -112.180484
},
"geometry": {
"kind": "radius",
"lat": 33.499313,
"lng": -112.180484,
"radius_miles": 2,
"bbox": null,
"property_id": null,
"address": null,
"zip": null,
"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": "5ca22a59",
"built_at": "2026-10-18T21:14:14.380Z",
"published_at": "2026-10-18T21:29:36.244Z",
"run_id": 1792358069,
"financing_as_of": "2026-06-25",
"recordings_through": "2026-06-11",
"financing_source": "replay_887",
"str_as_of": "2026-10-18"
},
{
"state": "CA",
"build_id": null,
"built_at": "2026-09-24T01:58:30.453Z",
"published_at": "2026-09-24T03:15:56.838Z",
"run_id": 1790215190,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "FL",
"build_id": "0e5fa9bc",
"built_at": "2026-09-24T15:08:23.506Z",
"published_at": "2026-09-24T18:59:42.805Z",
"run_id": 1790262682,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "TX",
"build_id": "775ed08d",
"built_at": "2026-09-24T11:08:10.587Z",
"published_at": "2026-09-24T13:16:03.157Z",
"run_id": 1790248213,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
}
]
}
},
"subject": {
"property_id": "af3af85f9f21671a0c7b7728a6faade3",
"place": "radius",
"zip": "85031",
"lat": 33.499313,
"lng": -112.180484,
"radius_miles": 2,
"segment": "SFR",
"price": 185000,
"price_low": 129500,
"price_high": 240500,
"period": "24m",
"since": "2024-09-23",
"financing_as_of": "2026-06-25"
}
}Rank the organizations with purchases like one parcel
The organizations with purchases like one subject, best match first: a parcel with its ZIP as the place or a radius around its point, or a point with a radius, in a window of 12, 24 or 36 months, of the segment and within 30 percent of the price when the subject has them. One keyset page, and the subject block says what ran.
Use it to find the buyers for a house. The rank rule is the contract: a change bumps the version. For every buyer of a ZIP use /v3/buyers.
A call costs 0 credits.
curl --request GET \
--url https://api.investorlift.com/v3/buyers/match \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/buyers/match', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/buyers/match"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"org_id": "AZ:L09606353",
"org_name": "ZAK VENTURES LLC",
"from_registry": true,
"n_like": 11,
"n_zip": 7,
"n_near": 12,
"n_near_12m": 5,
"last_like_date": "2026-09-01",
"last_near_date": "2026-09-01",
"nearest_miles": 0,
"median_like_price": 200000,
"price_p25_like": 186250,
"price_p75_like": 215000,
"n_deals_all": 226,
"n_entities": 39,
"company_like": null,
"is_active": true,
"days_since_last_purchase": 22,
"n_closings_as_buyer": 0,
"financing": {
"n_loans": 46,
"n_loans_24m": 5,
"n_lenders": 4,
"n_lenders_tagged_hard_money": 0,
"top_lender": {
"org_id": "AZ:name:FIRST FIDELITY BANK",
"org_name": "FIRST FIDELITY BANK",
"from_registry": false,
"tags": [
"bank",
"institution"
]
},
"last_loan_on": "2025-12-18",
"as_of": "2026-06-25"
}
},
{
"org_id": "AZ:name:OLYMPUS EQUITY",
"org_name": "OLYMPUS EQUITY LLC",
"from_registry": false,
"n_like": 3,
"n_zip": 3,
"n_near": 4,
"n_near_12m": 2,
"last_like_date": "2026-05-20",
"last_near_date": "2026-05-20",
"nearest_miles": 1.01,
"median_like_price": 231000,
"price_p25_like": 219000,
"price_p75_like": 231500,
"n_deals_all": null,
"n_entities": null,
"company_like": true,
"is_active": true,
"days_since_last_purchase": 126,
"n_closings_as_buyer": 2,
"financing": {
"n_loans": 0,
"n_loans_24m": 0,
"n_lenders": 0,
"n_lenders_tagged_hard_money": 0,
"top_lender": null,
"last_loan_on": null,
"as_of": "2026-06-25"
}
},
{
"org_id": "AZ:23140564",
"org_name": "ITZAE REAL ESTATE INVESTMENTS LLC",
"from_registry": true,
"n_like": 2,
"n_zip": 2,
"n_near": 2,
"n_near_12m": 2,
"last_like_date": "2026-09-04",
"last_near_date": "2026-09-04",
"nearest_miles": 0.48,
"median_like_price": 216000,
"price_p25_like": 208500,
"price_p75_like": 223500,
"n_deals_all": 3,
"n_entities": 1,
"company_like": null,
"is_active": true,
"days_since_last_purchase": 19,
"n_closings_as_buyer": 1,
"financing": {
"n_loans": 0,
"n_loans_24m": 0,
"n_lenders": 0,
"n_lenders_tagged_hard_money": 0,
"top_lender": null,
"last_loan_on": null,
"as_of": "2026-06-25"
}
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8bGVhbi1BWjE3OTIzNTgwNjktQ0ExNzkwMjE1MTkwLUZMMTc5MDI2MjY4Mi1UWDE3OTAyNDgyMTMiLCJxIjoiOGE3NDUyNGRmZjUwYWVjNWRlMGEyM2M4YTE1NjRkNTlmYjc2MDhiOTI2NjJmYmM4YTU0MGNkMWUwZjdjNTdiYyIsImsiOlsyLCIyMDI2LTA5LTA0IiwiQVo6MjMxNDA1NjQiXX0",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-10-18T21:38:34.282Z",
"reference_point": {
"lat": 33.499313,
"lng": -112.180484
},
"geometry": {
"kind": "radius",
"lat": 33.499313,
"lng": -112.180484,
"radius_miles": 2,
"bbox": null,
"property_id": null,
"address": null,
"zip": null,
"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": "5ca22a59",
"built_at": "2026-10-18T21:14:14.380Z",
"published_at": "2026-10-18T21:29:36.244Z",
"run_id": 1792358069,
"financing_as_of": "2026-06-25",
"recordings_through": "2026-06-11",
"financing_source": "replay_887",
"str_as_of": "2026-10-18"
},
{
"state": "CA",
"build_id": null,
"built_at": "2026-09-24T01:58:30.453Z",
"published_at": "2026-09-24T03:15:56.838Z",
"run_id": 1790215190,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "FL",
"build_id": "0e5fa9bc",
"built_at": "2026-09-24T15:08:23.506Z",
"published_at": "2026-09-24T18:59:42.805Z",
"run_id": 1790262682,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
},
{
"state": "TX",
"build_id": "775ed08d",
"built_at": "2026-09-24T11:08:10.587Z",
"published_at": "2026-09-24T13:16:03.157Z",
"run_id": 1790248213,
"financing_as_of": null,
"recordings_through": null,
"financing_source": null,
"str_as_of": null
}
]
}
},
"subject": {
"property_id": "af3af85f9f21671a0c7b7728a6faade3",
"place": "radius",
"zip": "85031",
"lat": 33.499313,
"lng": -112.180484,
"radius_miles": 2,
"segment": "SFR",
"price": 185000,
"price_low": 129500,
"price_high": 240500,
"period": "24m",
"since": "2024-09-23",
"financing_as_of": "2026-06-25"
}
}Authorizations
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
The subject parcel of the place index, 32 hex characters: its segment, its last price and its point. Alone, the place of the match is its ZIP. With radius_miles, the place is the radius around its point.
^[0-9a-f]{32}$Point latitude, with lng: the other subject. The place is the radius around it, and the match reads every segment and every price unless segment and price say otherwise. One of property_id, or lat with lng, is required.
-90 <= x <= 90Point longitude, with lat.
-180 <= x <= 180The radius in miles around the point or the parcel, 0.25 to 20. With a point the default is 2. A parcel with no radius takes its ZIP as the place.
0.25 <= x <= 20The window of the match before the data end of the state: 12m, 24m or 36m (default 36m).
12m, 24m, 36m The price the band is built on, whole US dollars, in place of the last price of the parcel.
0 <= x <= 9007199254740991The segment the match reads, in place of the segment of the last deed of the parcel: SFR, CONDO_TH or OTHER.
SFR, CONDO_TH, OTHER Page size, 1-500 (default 100).
1 <= x <= 500Opaque 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.
1 - 4096Response
The organizations with purchases like the subject, most first, then the newest, then the id, one keyset page. The rank rule: n_like counts the purchases in the place of the subject in the period, of the same segment when the subject has one, priced within 30 percent of its price when it has one.
The organizations with purchases like the subject, most first, then the newest, then the id, one keyset page. The rank rule: n_like counts the purchases in the place of the subject in the period, of the same segment when the subject has one, priced within 30 percent of its price when it has one.
The rows of this page.
Show child attributes
Show child attributes
Pagination: the page size, the rows returned and the cursor for the next page. Paged lists carry no total. The summary block does.
Show child attributes
Show child attributes
Response metadata of the /v3 family: when the API produced it, and the publishes behind the rows.
Show child attributes
Show child attributes
What the match compared the deals to: the place, the segment, the price band and the window.
Show child attributes
Show child attributes
Was this page helpful?