Skip to main content
POST
https://api.crustdata.com
/
person
/
search
curl --request POST \ --url https://api.crustdata.com/person/search \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'x-api-version: <x-api-version>' \ --data ' { "filters": { "field": "experience.employment_details.current.title", "type": "=", "value": "CEO" }, "limit": 1 } '
{ "profiles": [ { "basic_profile": { "name": "Nithin Kamath" }, "experience": { "employment_details": { "current": [ { "title": "CEO" }, { "title": "Founder & CEO" } ] } } } ], "next_cursor": "H4sIACIdzWkC...", "total_count": 1105055 }

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token in the Authorization header.

Headers

​
x-api-version
enum<string>
default:2025-11-01
required

API version to use. This endpoint currently requires 2025-11-01.

Available options:
2025-11-01
Example:

"2025-11-01"

Body

application/json

Search filters, sorting, pagination, and field selection options.

Request body for /person/search. Use filters (optionally grouped with and/or), sorts, limit, and cursor pagination.

​
filters
object
required

Filter criteria — a single PersonSearchCondition or an and/or PersonSearchConditionGroup.

Example:
{
  "field": "experience.employment_details.current.title",
  "type": "=",
  "value": "CEO"
}
​
sorts
object[]

Sort directives applied to matched people in order.

Example:
[
  {
    "field": "crustdata_person_id",
    "order": "asc"
  }
]
​
limit
integer
default:20
Required range: 1 <= x <= 1000
​
count
integer

Alias for limit.

Required range: 1 <= x <= 1000
Example:

20

​
cursor
string | null

Pagination cursor from a previous response's next_cursor. Omit on the first page.

Example:

"H4sIACIdzWkC..."

​
post_processing
object

Post-processing options applied to search results (e.g., exclusions).

Example:
{
  "exclude_profiles": ["https://www.linkedin.com/in/jane-doe"],
  "exclude_names": ["Jane Doe"]
}
​
return_query
boolean
default:false

Debug flag - include search query in response

​
preview
boolean
default:false

Preview mode - return only basic fields for faster response

​
fields
string[]

Optional list of field paths to include in each returned profile. When omitted, a default set of profile fields is returned. Use dot notation for a nested field (for example experience.employment_details.current.title) or a top-level family name (for example basic_profile) to include the whole family. An unsupported value returns a 400 whose metadata.available_fields lists every selectable field.

Example:
[
  "basic_profile.name",
  "experience.employment_details.current.title"
]

Response

People matching the search criteria

Paginated response from the person search endpoint containing matched profiles and pagination metadata.

​
profiles
object[]
required

Array of person profiles matching the search criteria

Example:
[]
​
next_cursor
string | null

Opaque cursor string for fetching the next page of results. Pass this value as the cursor parameter in subsequent requests. Null when no more results are available.

Example:

"H4sIACIdzWkC_xWMMQ7DIAwAv..."

​
total_count
integer | null

Total number of profiles matching the search criteria across all pages

Example:

1105055