List the current listings of the lean set near a place
curl --request GET \
--url https://api.investorlift.com/v3/listings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"listing_id": "d3e72b49f0c0068c70f2d011779699a7",
"property_id": "a03a80c431d2ac1878d5e619fa11a41b",
"address": {
"line": "2613 N 74th Pl",
"city": "Scottsdale",
"zip": "85257",
"apn": "131-28-175"
},
"latitude": 33.477252,
"longitude": -111.921199,
"address_held_back": null,
"location_radius_m": null,
"distance_miles": 0.05,
"status": "ACTIVE",
"status_detail": null,
"on_market": true,
"is_rental": false,
"listed_on": "2026-07-30",
"sold_on": null,
"off_market_on": null,
"status_updated_on": "2026-07-30",
"list_price": 568000,
"sold_price": null,
"price_high": 568000,
"days_on_market": 46,
"bedrooms": 3,
"bathrooms": 2,
"living_area": 1430,
"lot_sqft": 6534,
"year_built": 1959,
"property_type": "SINGLE_FAMILY",
"mls_number": "7060213",
"mls_name": "Arizona Regional Multiple Listing Service (ARMLS)",
"brokerage_name": "Rock Realty & Investments, LLC",
"n_agents": 1,
"agent_ids": [
"AZ:agt:25acfdbdd2ce"
],
"holder_org_ids": [],
"n_holder_orgs": 1,
"holder_from_registry": false
},
{
"listing_id": "4eed641984c260ea3b60ec31f1fb6504",
"property_id": "6bb1ec1646a23ad16ea4a502fc6aeb29",
"address": {
"line": "7433 E Cambridge Ave",
"city": "Scottsdale",
"zip": "85257",
"apn": "131-28-204"
},
"latitude": 33.477953,
"longitude": -111.919928,
"address_held_back": null,
"location_radius_m": null,
"distance_miles": 0.08,
"status": "ACTIVE",
"status_detail": null,
"on_market": true,
"is_rental": false,
"listed_on": "2026-08-28",
"sold_on": null,
"off_market_on": null,
"status_updated_on": "2026-09-01",
"list_price": 799000,
"sold_price": null,
"price_high": 799000,
"days_on_market": 17,
"bedrooms": 3,
"bathrooms": 2,
"living_area": null,
"lot_sqft": 6098,
"year_built": 1959,
"property_type": "SFR",
"mls_number": "7067313",
"mls_name": null,
"brokerage_name": null,
"n_agents": 1,
"agent_ids": [
"AZ:agt:53b5df5a4da3"
],
"holder_org_ids": [],
"n_holder_orgs": 2,
"holder_from_registry": false
},
{
"listing_id": "91591de51eeb5d032df203107d1ae94b",
"property_id": "5ccb07e7e6f1948fc3e21942a8cb6b36",
"address": {
"line": "7513 E Cambridge Ave",
"city": "Scottsdale",
"zip": "85257",
"apn": "131-28-208"
},
"latitude": 33.477953,
"longitude": -111.919004,
"address_held_back": null,
"location_radius_m": null,
"distance_miles": 0.11,
"status": "PENDING",
"status_detail": null,
"on_market": true,
"is_rental": false,
"listed_on": "2026-07-07",
"sold_on": null,
"off_market_on": null,
"status_updated_on": "2026-07-07",
"list_price": 715900,
"sold_price": null,
"price_high": 715900,
"days_on_market": 0,
"bedrooms": 3,
"bathrooms": 2,
"living_area": 1625,
"lot_sqft": 6969,
"year_built": 1959,
"property_type": "SINGLE_FAMILY",
"mls_number": "7050818",
"mls_name": "Arizona Regional Multiple Listing Service (ARMLS)",
"brokerage_name": "HomeSmart",
"n_agents": 1,
"agent_ids": [
"AZ:agt:814b64ee71e6"
],
"holder_org_ids": [],
"n_holder_orgs": 1,
"holder_from_registry": false
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8bGVhbi1BWjE3OTAxMjM3NTIiLCJxIjoiOWE0MDBhNzcxZTAwM2MyZmEyOGU3ZDk1OGE0NmQxMDc5ZjU4MzE2ZTcxZTEzOGUwZTdhMTJjYTg2ZDI3NmU0YyIsImsiOlsxNzIuMjY4NDY3NzQwNzk0MSwiOTE1OTFkZTUxZWViNWQwMzJkZjIwMzEwN2QxYWU5NGIiXX0",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-09-23T01:23:32.928Z",
"reference_point": {
"lat": 33.476917,
"lng": -111.920385
},
"geometry": {
"kind": "radius",
"lat": 33.476917,
"lng": -111.920385,
"radius_miles": 1,
"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": null,
"built_at": "2026-09-22T13:41:32.949Z",
"published_at": "2026-09-23T01:02:16.717Z",
"run_id": 1790123752
}
]
}
}
}Lean set (/v3)
List the current listings of the lean set near a place
List the current listings of the lean set near a place.
GET
/
v3
/
listings
List the current listings of the lean set near a place
curl --request GET \
--url https://api.investorlift.com/v3/listings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"listing_id": "d3e72b49f0c0068c70f2d011779699a7",
"property_id": "a03a80c431d2ac1878d5e619fa11a41b",
"address": {
"line": "2613 N 74th Pl",
"city": "Scottsdale",
"zip": "85257",
"apn": "131-28-175"
},
"latitude": 33.477252,
"longitude": -111.921199,
"address_held_back": null,
"location_radius_m": null,
"distance_miles": 0.05,
"status": "ACTIVE",
"status_detail": null,
"on_market": true,
"is_rental": false,
"listed_on": "2026-07-30",
"sold_on": null,
"off_market_on": null,
"status_updated_on": "2026-07-30",
"list_price": 568000,
"sold_price": null,
"price_high": 568000,
"days_on_market": 46,
"bedrooms": 3,
"bathrooms": 2,
"living_area": 1430,
"lot_sqft": 6534,
"year_built": 1959,
"property_type": "SINGLE_FAMILY",
"mls_number": "7060213",
"mls_name": "Arizona Regional Multiple Listing Service (ARMLS)",
"brokerage_name": "Rock Realty & Investments, LLC",
"n_agents": 1,
"agent_ids": [
"AZ:agt:25acfdbdd2ce"
],
"holder_org_ids": [],
"n_holder_orgs": 1,
"holder_from_registry": false
},
{
"listing_id": "4eed641984c260ea3b60ec31f1fb6504",
"property_id": "6bb1ec1646a23ad16ea4a502fc6aeb29",
"address": {
"line": "7433 E Cambridge Ave",
"city": "Scottsdale",
"zip": "85257",
"apn": "131-28-204"
},
"latitude": 33.477953,
"longitude": -111.919928,
"address_held_back": null,
"location_radius_m": null,
"distance_miles": 0.08,
"status": "ACTIVE",
"status_detail": null,
"on_market": true,
"is_rental": false,
"listed_on": "2026-08-28",
"sold_on": null,
"off_market_on": null,
"status_updated_on": "2026-09-01",
"list_price": 799000,
"sold_price": null,
"price_high": 799000,
"days_on_market": 17,
"bedrooms": 3,
"bathrooms": 2,
"living_area": null,
"lot_sqft": 6098,
"year_built": 1959,
"property_type": "SFR",
"mls_number": "7067313",
"mls_name": null,
"brokerage_name": null,
"n_agents": 1,
"agent_ids": [
"AZ:agt:53b5df5a4da3"
],
"holder_org_ids": [],
"n_holder_orgs": 2,
"holder_from_registry": false
},
{
"listing_id": "91591de51eeb5d032df203107d1ae94b",
"property_id": "5ccb07e7e6f1948fc3e21942a8cb6b36",
"address": {
"line": "7513 E Cambridge Ave",
"city": "Scottsdale",
"zip": "85257",
"apn": "131-28-208"
},
"latitude": 33.477953,
"longitude": -111.919004,
"address_held_back": null,
"location_radius_m": null,
"distance_miles": 0.11,
"status": "PENDING",
"status_detail": null,
"on_market": true,
"is_rental": false,
"listed_on": "2026-07-07",
"sold_on": null,
"off_market_on": null,
"status_updated_on": "2026-07-07",
"list_price": 715900,
"sold_price": null,
"price_high": 715900,
"days_on_market": 0,
"bedrooms": 3,
"bathrooms": 2,
"living_area": 1625,
"lot_sqft": 6969,
"year_built": 1959,
"property_type": "SINGLE_FAMILY",
"mls_number": "7050818",
"mls_name": "Arizona Regional Multiple Listing Service (ARMLS)",
"brokerage_name": "HomeSmart",
"n_agents": 1,
"agent_ids": [
"AZ:agt:814b64ee71e6"
],
"holder_org_ids": [],
"n_holder_orgs": 1,
"holder_from_registry": false
}
],
"page": {
"next_cursor": "eyJ2IjoxLCJydW4iOiJ8bGVhbi1BWjE3OTAxMjM3NTIiLCJxIjoiOWE0MDBhNzcxZTAwM2MyZmEyOGU3ZDk1OGE0NmQxMDc5ZjU4MzE2ZTcxZTEzOGUwZTdhMTJjYTg2ZDI3NmU0YyIsImsiOlsxNzIuMjY4NDY3NzQwNzk0MSwiOTE1OTFkZTUxZWViNWQwMzJkZjIwMzEwN2QxYWU5NGIiXX0",
"limit": 3,
"returned": 3
},
"meta": {
"generated_at": "2026-09-23T01:23:32.928Z",
"reference_point": {
"lat": 33.476917,
"lng": -111.920385
},
"geometry": {
"kind": "radius",
"lat": 33.476917,
"lng": -111.920385,
"radius_miles": 1,
"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": 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/listings. See The lean dataset for the tier rules.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
Point latitude, with lng: the centre of a radius. One of lat with lng, address with zip, zip, or bbox is required.
Required range:
-90 <= x <= 90Point longitude, with lat.
Required range:
-180 <= x <= 180The radius in miles around the point or the address, 0.25 to 20 (default 1).
Required range:
0.25 <= x <= 20A street line, with zip: the API resolves it to a parcel and searches the radius around it. For example 7522 E Cholla St with zip 85254.
Required string length:
3 - 200A place as a list of 5-digit ZIPs (comma list or repeated key), at most 20. With address, the one ZIP of the address.
Minimum array length:
1Pattern:
^\d{5}$Viewport as west,south,east,north (WGS84 degrees), the diagonal at most 40 mi.
True keeps the listings on the market at the data end: active and pending. False keeps every current listing, sold and off-market ones too. Default true.
Available options:
true, false True keeps rentals alone, false keeps sales alone. Default: both.
Available options:
true, false The row order. distance puts the nearest listing first and needs a point. listed_desc puts the newest listing first. price_asc and price_desc order on the list price, unpriced rows last. The default is distance with a point, else listed_desc. Every sort breaks a tie on the listing id.
Available options:
distance, listed_desc, price_asc, price_desc Page size, 1-500 (default 100).
Required range:
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.
Required string length:
1 - 4096Response
The current listings near the place, one page.
The current listings near the place, one page.
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 lean family: when the API produced it, and the publishes behind the rows.
Show child attributes
Show child attributes
Was this page helpful?