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
}
]
}
}
}Search the agents of the lean set
The agents of the lean set by a name, a licence number, a brokerage or a phone, the most listings first, one page with no cursor: the identity facts, the brokerage and the counts of each, with its person id.
by says what q is. A name search reads a prefix of the folded name or of a word of it; a licence and a phone search read the digits alone; a brokerage search folds the name. A deals-only key runs the brokerage search alone: this host serves none of a name, a licence or a phone.
A call costs 0 credits.
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
}
]
}
}
}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.
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.
name, licence, brokerage, phone One state alone. Default: every served state.
^[A-Z]{2}$Agents to return, 1 to 50 (default 10).
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?