Search the agents of the lean set
curl --request GET \
--url https://api.investorlift.com/v3/agents/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/agents/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/agents/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"agent_id": "AZ:agt:9fbb59cffb5a",
"person_id": "AZ:agt:9fbb59cffb5a",
"state": "AZ",
"name": null,
"kind": "PERSON",
"identity_basis": "licence",
"has_licence": true,
"current_brokerage": "West USA Realty",
"n_listings": 1071,
"n_active": 13,
"last_listed_on": "2026-09-13",
"last_zip": "85373"
},
{
"agent_id": "AZ:agt:1811be750924",
"person_id": "AZ:agt:1811be750924",
"state": "AZ",
"name": null,
"kind": "PERSON",
"identity_basis": "licence",
"has_licence": true,
"current_brokerage": "West USA Realty",
"n_listings": 613,
"n_active": 15,
"last_listed_on": "2026-09-12",
"last_zip": "85297"
},
{
"agent_id": "AZ:agt:d2744b66bffd",
"person_id": "person:b24e14be6a9b",
"state": "AZ",
"name": null,
"kind": "PERSON",
"identity_basis": "licence",
"has_licence": true,
"current_brokerage": "West USA Realty",
"n_listings": 553,
"n_active": 2,
"last_listed_on": "2026-09-13",
"last_zip": "85304"
}
],
"page": {
"next_cursor": null,
"limit": 3,
"returned": 3,
"capped": true
},
"meta": {
"generated_at": "2026-09-23T03:03:14.689Z",
"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)
Search the agents of the lean set
Search the agents of the lean set.
GET
/
v3
/
agents
/
search
Search the agents of the lean set
curl --request GET \
--url https://api.investorlift.com/v3/agents/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/agents/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/agents/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"agent_id": "AZ:agt:9fbb59cffb5a",
"person_id": "AZ:agt:9fbb59cffb5a",
"state": "AZ",
"name": null,
"kind": "PERSON",
"identity_basis": "licence",
"has_licence": true,
"current_brokerage": "West USA Realty",
"n_listings": 1071,
"n_active": 13,
"last_listed_on": "2026-09-13",
"last_zip": "85373"
},
{
"agent_id": "AZ:agt:1811be750924",
"person_id": "AZ:agt:1811be750924",
"state": "AZ",
"name": null,
"kind": "PERSON",
"identity_basis": "licence",
"has_licence": true,
"current_brokerage": "West USA Realty",
"n_listings": 613,
"n_active": 15,
"last_listed_on": "2026-09-12",
"last_zip": "85297"
},
{
"agent_id": "AZ:agt:d2744b66bffd",
"person_id": "person:b24e14be6a9b",
"state": "AZ",
"name": null,
"kind": "PERSON",
"identity_basis": "licence",
"has_licence": true,
"current_brokerage": "West USA Realty",
"n_listings": 553,
"n_active": 2,
"last_listed_on": "2026-09-13",
"last_zip": "85304"
}
],
"page": {
"next_cursor": null,
"limit": 3,
"returned": 3,
"capped": true
},
"meta": {
"generated_at": "2026-09-23T03:03:14.689Z",
"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/agents/search. 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
The text to search.
Required string length:
2 - 120What q is. name: a name of an agent, a prefix of the folded name or of a word of it. licence: the digits of a licence number. brokerage: a brokerage name, folded. phone: a phone, the digits alone. The default is name. A deals-only key runs a brokerage search alone: this host serves none of a name, a licence or a phone.
Available options:
name, licence, brokerage, phone One state alone. Default: every served state.
Pattern:
^[A-Z]{2}$Agents to return, 1 to 50 (default 10).
Required range:
1 <= x <= 50Response
The agents the search found, the most listings first, one page with no cursor.
The agents the search found, the most listings first, one page with no cursor.
The hits, best match first.
Show child attributes
Show child attributes
The page block of a name search: no cursor, the limit applied, the hits returned and if the API cut the page at the limit.
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?