Search people
Substring search across people in your org's network.
GET /api/v1/search/peopleSubstring search across people known by anyone in your organization. It includes 1st-degree direct connections and 2nd-degree connections by default. Matches name, email, position, and current company.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | yes | Free-text query. |
limit | number | no | 1-50, default 20. |
includeSecondDegree | boolean | no | Include 2nd-degree connections. Default true. |
Example
curl -H "Authorization: Bearer $KEY" \"https://app.usehomie.com/api/v1/search/people?q=alex&limit=10"Response
{
"data": [
{
"id": "person_...",
"name": "Alex Johnson",
"linkedinId": "alexjohnson",
"position": "VP Engineering",
"company": "Stripe",
"city": "San Francisco",
"warmness": 84,
"warmnessBreakdown": {
"currentCompanyMatch": 65,
"sameCity": 5,
"sharedAccelerator": 14
},
"degree": "first",
"knownByUserIds": ["user_..."],
"introRequested": true,
"introStatus": "ACTIVE",
"introRequestedBy": "Sarah Chen",
"introRequestedAt": "2026-09-10T12:00:00.000Z"
}
]
}The degree field is "first" for direct connections and "second" for 2nd-degree. warmnessBreakdown is a free-form object whose keys are warmness factor names (e.g. currentCompanyMatch, pastCompanyOverlap, sharedAccelerator, sameCity). Results are sorted with 1st-degree first, then by warmness descending.
If anyone in your organization has already requested an introduction to a person, that result also carries introRequested, introStatus, introRequestedBy, and introRequestedAt. These fields are omitted when no request exists. Search does not hide people who already have a request.