curl --request GET \
--url https://api.investorlift.com/v3/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"kind": "entity",
"match": "exact",
"text": "ZAK VENTURES LLC",
"id": "L10511200",
"state": "AZ",
"person_id": null,
"agent_id": null,
"org_id": "AZ:L09606353",
"org_name": "ZAK VENTURES LLC",
"roles": [],
"n_listings": 0,
"n_deals": 226,
"n_entities": 39
},
{
"kind": "entity",
"match": "exact",
"text": "ZAK VENTURES LLC",
"id": "0806262634",
"state": "TX",
"person_id": null,
"agent_id": null,
"org_id": "TX:0806262634",
"org_name": "ZAK VENTURES LLC",
"roles": [],
"n_listings": 0,
"n_deals": 13,
"n_entities": 1
},
{
"kind": "lender",
"match": "exact",
"text": "ZAK VENTURES LLC",
"id": "AZ:L09606353",
"state": "AZ",
"person_id": null,
"agent_id": null,
"org_id": "AZ:L09606353",
"org_name": "ZAK VENTURES LLC",
"roles": [],
"n_listings": 0,
"n_deals": 2,
"n_entities": 0
}
],
"page": {
"next_cursor": null,
"limit": 3,
"returned": 3,
"capped": true
},
"meta": {
"generated_at": "2026-10-18T21:38:34.282Z",
"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
}
]
}
}
}Search the dataset by name
The persons, agents, entities and organizations that a name finds in the dataset, best match first, one page with no cursor. The API folds the name and matches a prefix of it, or of any word of it. Each hit has its kind, its roles, its counts and the person or organization it points at.
Use it to get an id from a name. A deals-only key finds an entity and a former name alone. Then open /v3/orgs/{id} or /v3/people/{id}.
A call costs 0 credits.
curl --request GET \
--url https://api.investorlift.com/v3/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.investorlift.com/v3/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/v3/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"kind": "entity",
"match": "exact",
"text": "ZAK VENTURES LLC",
"id": "L10511200",
"state": "AZ",
"person_id": null,
"agent_id": null,
"org_id": "AZ:L09606353",
"org_name": "ZAK VENTURES LLC",
"roles": [],
"n_listings": 0,
"n_deals": 226,
"n_entities": 39
},
{
"kind": "entity",
"match": "exact",
"text": "ZAK VENTURES LLC",
"id": "0806262634",
"state": "TX",
"person_id": null,
"agent_id": null,
"org_id": "TX:0806262634",
"org_name": "ZAK VENTURES LLC",
"roles": [],
"n_listings": 0,
"n_deals": 13,
"n_entities": 1
},
{
"kind": "lender",
"match": "exact",
"text": "ZAK VENTURES LLC",
"id": "AZ:L09606353",
"state": "AZ",
"person_id": null,
"agent_id": null,
"org_id": "AZ:L09606353",
"org_name": "ZAK VENTURES LLC",
"roles": [],
"n_listings": 0,
"n_deals": 2,
"n_entities": 0
}
],
"page": {
"next_cursor": null,
"limit": 3,
"returned": 3,
"capped": true
},
"meta": {
"generated_at": "2026-10-18T21:38:34.282Z",
"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
}
]
}
}
}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 name to find, 2 to 200 characters. The API folds it the way the build keyed each name, and a prefix of the text, or of any word of it, finds the name.
2 - 200Keep only hits of these kinds (comma list or repeated key): entity, former_name, person, agent_name, lender, wholesaler. Another word answers 400. Default: every kind the key reads.
1What the hit is. entity: an entity of a business registry under its filed name. former_name: an entity under a name it filed before. person: a person, whatever the roles, under any spelling of its sightings: the index carries one hit for each person and each spelling, so a search by any spelling finds the one person. agent_name: a second spelling of the name of an agent, a person hit since API 1.35.0, so a state built since then carries none. lender: a lender organization under a spelling of its loans. wholesaler: a seller of the Investorlift marketplaces under the display form of the name the marketplace gives it. A deals-only key gets entity, former_name, lender and wholesaler hits alone. A lender hit whose name reads as a person is withheld from it. The list can grow: a client keeps an unknown kind as a hit it does not read.
entity, former_name, person, agent_name, lender, wholesaler Keep only hits of one served state. Default: every served state.
^[A-Z]{2}$hits to return, 1 to 50 (default 10).
1 <= x <= 50Response
The hits of the name search, best match first, one page with no cursor. A lender hit ranks by its loans where an entity ranks by its purchases.
The hits of the name search, best match first, one page with no cursor. A lender hit ranks by its loans where an entity ranks by its purchases.
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 /v3 family: when the API produced it, and the publishes behind the rows.
Show child attributes
Show child attributes
Was this page helpful?