Skip to main content
POST
https://api.crustdata.com
/
person
/
professional_network
/
search
/
live
Search people in real-time via LinkedIn Sales Navigator
curl --request POST \
  --url https://api.crustdata.com/person/professional_network/search/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '
{
  "filters": [
    {
      "field": "CURRENT_TITLE",
      "type": "in",
      "value": [
        "CEO"
      ]
    },
    {
      "field": "COMPANY_HEADCOUNT",
      "type": "in",
      "value": [
        "11-50"
      ]
    }
  ],
  "page": 1
}
'
{
  "profiles": [
    {
      "basic_profile": {
        "name": "Jane Smith",
        "headline": "CEO at TechStartup",
        "current_title": "CEO"
      },
      "social_handles": {
        "professional_network_identifier": {
          "profile_url": "https://www.linkedin.com/in/janesmith"
        }
      },
      "experience": {
        "employment_details": {
          "current": [
            {
              "title": "CEO",
              "name": "TechStartup"
            }
          ]
        }
      }
    }
  ],
  "total_display_count": "2,500"
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-api-version
string
required

API version to use. Must match a supported version (e.g., "2025-11-01").

Example:

"2025-11-01"

Body

application/json

Sales Navigator filters, pagination, and optional background job configuration.

Request body for real-time person search via LinkedIn Sales Navigator.

​
job_id
string<uuid>

UUID of a previously submitted background job to retrieve results for

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
professional_network_search_url
string

Professional network search URL for person search

Example:

"https://www.linkedin.com/sales/search/people?query=..."

​
filters
object[]

Array of Sales Navigator filter objects

Example:
[
  {
    "field": "CURRENT_TITLE",
    "type": "in",
    "value": ["CEO"]
  },
  {
    "field": "COMPANY_HEADCOUNT",
    "type": "in",
    "value": ["11-50"]
  }
]
​
page
integer

Page number for pagination (required when using filters with synchronous search)

Required range: x >= 1
Example:

1

​
limit
integer

Maximum number of profiles to fetch

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

25

​
background_job
boolean

Set to true to process the search asynchronously

Example:

false

​
preview
boolean

Preview mode - return only basic fields. Cannot be combined with page, limit, background_job, or post_processing.

Example:

false

​
post_processing
object

Post-processing options for excluding profiles or names from results

Example:
{
  "exclude_profiles": [],
  "exclude_names": []
}

Response

Person profiles matching the search criteria

Response from the real-time person search endpoint.

​
profiles
object[]

List of person profiles found

Example:
[]
​
total_display_count
string

Total number of profiles available based on the search

Example:

"2,500+"