CrustData V3: Person Search

Cheap indexed person discovery by title, employer, seniority, location, education, skills, contact availability, and semantic query.

Tool ID: crustdata_v3_person_search

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'crustdata_v3_person_search',
  {
    "filters": {
      "field": "email",
      "type": "=",
      "value": "example"
    }
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute crustdata_v3_person_search --input '{
  "filters": {
    "field": "email",
    "type": "=",
    "value": "example"
  }
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "profiles": [
      {
        "crustdata_person_id": 123,
        "basic_profile": {
          "name": "Example",
          "headline": "example",
          "current_title": "example"
        },
        "contact": {
          "has_business_email": true,
          "has_personal_email": true,
          "has_phone_number": true
        }
      }
    ]
  }
}

Use deepline tools get crustdata_v3_person_search --json for the latest machine-readable contract.

Input reference

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

Name	Type	Required	Default	Details
`payload.filters`	`object`	Yes	—	Filter criteria — a single `PersonSearchCondition` or a `PersonSearchConditionGroup` combining conditions with `and`, `or`, or `all_of` (cross-element matching on nested-array fields).
`payload.sorts`	`array`	No	`[]`	Sort directives applied to matched people in order.
`payload.limit`	`integer`	No	`20`	Minimum: 1. Maximum: 1000.
`payload.count`	`integer`	No	—	Alias for limit. Minimum: 1. Maximum: 1000.
`payload.cursor`	`string`	No	—	Pagination cursor from a previous response’s `next_cursor`. Omit on the first page.
`payload.post_processing`	`object`	No	—	Post-processing options applied to search results (e.g., exclusions).
`payload.return_query`	`boolean`	No	`false`	Debug flag - include search query in response
`payload.preview`	`boolean`	No	`false`	Preview mode - return only basic fields for faster response
`payload.fields`	`array`	No	—	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.

This input schema is too large to embed without slowing the page. Get the complete live contract with deepline tools get crustdata_v3_person_search --json.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Paginated response from the person search endpoint containing matched profiles and pagination metadata.
`result.data.profiles`	`array`	Yes	—	Array of person profiles matching the search criteria
`result.data.profiles[].crustdata_person_id`	`integer`	No	—	—
`result.data.profiles[].basic_profile`	`object`	No	—	—
`result.data.profiles[].basic_profile.name`	`string`	No	—	—
`result.data.profiles[].basic_profile.headline`	`string`	No	—	—
`result.data.profiles[].basic_profile.current_title`	`string`	No	—	—
`result.data.profiles[].basic_profile.professional_network_name`	`string \| null`	No	—	Display name on the person’s professional-network profile.
`result.data.profiles[].basic_profile.profile_picture_permalink`	`string \| null`	No	—	—
`result.data.profiles[].basic_profile.location`	`object \| null`	No	—	—
`result.data.profiles[].basic_profile.location.city`	`string \| null`	No	—	—
`result.data.profiles[].basic_profile.location.state`	`string \| null`	No	—	—
`result.data.profiles[].basic_profile.location.country`	`string \| null`	No	—	—
`result.data.profiles[].basic_profile.location.continent`	`string \| null`	No	—	—
`result.data.profiles[].basic_profile.location.raw`	`string \| null`	No	—	—
`result.data.profiles[].basic_profile.normalized_title`	`object \| null`	No	—	Job Title Normalization (JTN, beta) — structured representation of the person’s current title mapped to Crustdata’s proprietary taxonomy (20 departments, 226 sub-departments). See https://docs.crustdata.com/guides/job-title-normalization.
`result.data.profiles[].basic_profile.normalized_title.matched_title`	`string \| null`	No	—	Canonical normalized title matched to the person’s current title.
`result.data.profiles[].basic_profile.normalized_title.department`	`string \| null`	No	—	High-level department the normalized title maps to.
`result.data.profiles[].basic_profile.normalized_title.sub_department`	`string \| null`	No	—	More granular classification within the department.
`result.data.profiles[].basic_profile.normalized_title.similarity`	`number \| null`	No	—	Similarity score between the raw title and the matched normalized title, from 0 to 1.
`result.data.profiles[].basic_profile.normalized_title.confident`	`boolean \| null`	No	—	Whether the normalized-title match is considered confident.
`result.data.profiles[].contact`	`object`	No	—	Contact-availability flags for a person — indicates whether email or phone data is present.
`result.data.profiles[].contact.has_business_email`	`boolean`	No	—	Whether person has a verified business email
`result.data.profiles[].contact.has_personal_email`	`boolean`	No	—	Whether person has a personal email on file
`result.data.profiles[].contact.has_phone_number`	`boolean`	No	—	Whether person has a phone number on file
`result.data.profiles[].social_handles`	`object`	No	—	—
`result.data.profiles[].social_handles.professional_network_identifier`	`object`	No	—	—
`result.data.profiles[].social_handles.professional_network_identifier.profile_url`	`string`	No	—	—
`result.data.profiles[].social_handles.dev_platform_identifier`	`object`	No	—	—
`result.data.profiles[].social_handles.dev_platform_identifier.profile_url`	`string \| null`	No	—	—
`result.data.profiles[].social_handles.twitter_identifier`	`object \| null`	No	—	The person’s handle on X (formerly Twitter), when available.
`result.data.profiles[].social_handles.twitter_identifier.slug`	`string \| null`	No	—	The X/Twitter handle slug (the portion after the profile URL host). May be an empty string when no handle is on file.
`result.data.profiles[].experience`	`object`	No	—	—
`result.data.profiles[].experience.employment_details`	`object`	No	—	—
`result.data.profiles[].experience.employment_details.current`	`array`	No	—	—
`result.data.profiles[].experience.employment_details.current[].name`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].professional_network_id`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].title`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].description`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].location`	`object \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].location.raw`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].employment_type`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].start_date`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].end_date`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].is_default`	`boolean \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].crustdata_company_id`	`integer \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].company_website_domain`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].company_profile_picture_permalink`	`string \| null`	No	—	Stable Crustdata-hosted permalink to the company logo, suitable for rendering in your own interface.
`result.data.profiles[].experience.employment_details.current[].company_professional_network_profile_url`	`string \| null`	No	—	—
`result.data.profiles[].experience.employment_details.current[].seniority_level`	`string \| null`	No	—	—

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large to embed without slowing the page. Get the complete live contract with deepline tools get crustdata_v3_person_search --json.

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.02 per pricing unit.

Getting Started

GTM is code

Features

Deepline SDK beta

Integrations

API Reference

CrustData V3: Person Search

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation