search.people
Search people with structured filters.
Signature
people(body: SearchPeopleBody & SearchPeopleQuery): Promise<SearchPeopleResult>Example
import { Curviate } from "@curviate/sdk";
const curviate = new Curviate({
apiKey: "cvt_live_…",
baseUrl: "https://api.curviate.com",
});
const page = await curviate.account("acc_YOUR_ACCOUNT_ID").search.people();
for (const item of page.items ?? []) {
console.log(item.id);
}
// `page.cursor` is the opaque cursor for the next page (null when exhausted).Parameters
| Name | Type | Required | Description |
|---|---|---|---|
offset | number | No | Zero-based pagination offset (default 0). |
limit | number | No | Maximum results per page (1–50, default 10). |
cursor | string | No | Opaque pagination cursor returned from a previous response. |
keywords | string | No | Full-text keyword search across all profile fields. |
advanced_keywords | object | No | Keyword filters scoped to specific profile fields (first_name, last_name, title, company, school). |
industry | array | No | Opaque industry IDs from GET./search/parameters?type=INDUSTRY. |
location | array | No | Opaque location IDs from GET./search/parameters?type=LOCATION. |
current_company | array | No | Opaque current company IDs from GET./search/parameters?type=COMPANY. |
past_company | array | No | Opaque past company IDs from GET./search/parameters?type=COMPANY. |
school | array | No | Opaque school IDs from GET./search/parameters?type=SCHOOL. |
service | array | No | Opaque service IDs from GET./search/parameters?type=SERVICE. |
connections_of | array | No | Filter to connections of the given members. Array of opaque member IDs from GET./search/parameters?type=RELATION. |
followers_of | array | No | Filter to followers of the given members. Array of opaque member IDs from GET./search/parameters?type=PEOPLE. |
network_distance | array | No | Filter by network distance: 1 = 1st degree, 2 = 2nd degree, 3 = 3rd degree. |
profile_language | array | No | Filter by profile language codes. |
open_to_volunteering | boolean | No | Filter to profiles open to volunteering opportunities. |
Returns
Resolves to SearchPeopleResult. Top-level fields: object, items, paging, cursor.
Error codes
UNAUTHORIZEDINVALID_REQUESTRATE_LIMIT_ACCOUNTRATE_LIMIT_TENANTPLATFORM_RATE_LIMITPLATFORM_ERRORRESOURCE_NOT_FOUND
All error codes link to Error codes reference.
Notes
Note: The
account_idis injected automatically by the account-scoped accessor. Call ascurviate.account("acc_YOUR_ACCOUNT_ID").search.people(...).