Title100/100
Search people
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Returns people from Crustdata's index of 800M+ professional profiles, each with a LinkedIn profile URL, employment history with dates, education and location, that match filters on current or past employer, title, seniority, function, location, school, skills, years of experience or job start date, or a plain-language `search`: decision makers and leaders at a company, employees, alumni, people who previously worked at a company, people who changed jobs since a date, candidates for a role. Returns up to `limit` profiles with total_count and next_cursor; get_person_contact_info returns emails and phone numbers. 0.03 credits per profile returned. Premium field groups (experience, education, skills and others) add a per-profile charge when filtered on or returned; the default fields include the current employer, from the experience group, and `fields` adds full history and education. get_plan_access lists this key's prices. Field paths and value formats: list_search_fields. Stored values for titles, seniority, functions and industries: autocomplete_person_filter. A company filter takes identify_company's crustdata_company_id on experience.employment_details.current.company_id, or a bare domain such as stripe.com on experience.employment_details.current.company_website_domain.
The description explains the capability, when to use it, and what to expect.
Inputs74/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 0 › field
A filterable person field path, e.g. experience.employment_details.current.title. list_search_fields lists them.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 0 › type
Operator: =, != for an exact value; <, =<, >, => for numbers and dates; in, not_in with a list; (.) for all the words in any order; [.] for an exact phrase; (!) to exclude a phrase; is_null, is_not_null with value null; has_all with a list, each value on some entry of the employment, education, certification or honor fields; geo_distance, geo_exclude with a radius.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 0 › value
A string, number or boolean to compare; a list for in, not_in and has_all; null for is_null and is_not_null; a radius for geo_distance and geo_exclude.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › op
and: every condition matches (on a history array, the same entry); or: any condition matches; all_of: each condition matches some entry of a history array, possibly a different one (two jobs, two degrees).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 0 › field
Field path.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 0 › type
Operator, as at the top level.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 0 › value
Value, as at the top level.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 1 › op
As at the top level.
Explain the meaning of this value, not just its name.
filters › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › anyOf › 0 › field
Field path.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › anyOf › 0 › type
Operator, as at the top level.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › anyOf › 0 › value
Value, as at the top level.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › anyOf › 1 › op
As at the top level.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › field
Field path.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › type
Operator, as at the top level.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › anyOf › 1 › conditions › items › value
Value, as at the top level.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
search › query
Plain-language description of the people, e.g. "backend engineers in Singapore who worked at fintech startups".
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
search › mode
hybrid (default) mixes keyword and meaning; lexical matches the words; semantic matches the meaning.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
mode
With `search` only. managed (default) widens recall by OR-ing constraints read from the query text with `filters`; exact uses only `filters`, for a reproducible total_count.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
sorts › items › field
Field to sort on; list_search_fields lists the sortable fields.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
sorts › items › order
Sort direction.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
fields
Field groups or dot-paths to return, e.g. ["basic_profile", "experience", "education"]. Only the listed fields come back; omitted, name, current title, current employer and its crustdata_company_id, location, LinkedIn profile URL and crustdata_person_id, and fit with `search`.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
Records to return, 1 to 100.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
next_cursor from the previous page of the same query.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema0/100
No output schema is declared. Add one for structured results so clients can interpret returned fields.
Not declared