> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CrustData V2: People Search Realtime

> Search for people on the web in real time using a set of filters. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Search for people on the web in real time using a set of filters.

> [!NOTE]
>
> Tool ID: `crustdata_v2_people_search_realtime`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'crustdata_v2_people_search_realtime',
  {
    "filters": [
      {
        "filter_type": "example",
        "type": "in",
        "value": [
          "example"
        ]
      }
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute crustdata_v2_people_search_realtime --input '{
  "filters": [
    {
      "filter_type": "example",
      "type": "in",
      "value": [
        "example"
      ]
    }
  ]
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe crustdata_v2_people_search_realtime --json` for the complete live contract.

## Input reference

Searches for people based on either a set of filters. - **Filters**: Provide an array of filter\_type, type, and value. See [How to Build Filters](https://docs.crustdata.com/docs/discover/people-apis/how-to-build-people-filters). [Show Docs](https://docs.crustdata.com/docs/discover/people-apis/people-search-api)

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.filters` | `array` | Yes | — | Each item contains filter\_type, type, value. For details, see [How to Build Filters](https://docs.crustdata.com/docs/discover/people-apis/how-to-build-people-filters). |
| `payload.page` | `integer` | No | `1` | The page number for pagination (starts from 1). Default is 1. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Searches for people based on either a set of filters. - **Filters**: Provide an array of filter_type, type, and value. See [How to Build Filters](https://docs.crustdata.com/docs/discover/people-apis/how-to-build-people-filters). [Show Docs](https://docs.crustdata.com/docs/discover/people-apis/people-search-api)",
    "properties": {
      "filters": {
        "type": "array",
        "description": "Each item contains filter_type, type, value. For details, see [How to Build Filters](https://docs.crustdata.com/docs/discover/people-apis/how-to-build-people-filters).",
        "items": {
          "type": "object",
          "properties": {
            "filter_type": {
              "type": "string",
              "description": "The filter to apply (e.g. FIRST_NAME, LAST_NAME, CURRENT_COMPANY, REGION, etc.)"
            },
            "type": {
              "type": "string",
              "enum": [
                "in",
                "not in",
                "between"
              ]
            },
            "value": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        }
      },
      "page": {
        "type": "integer",
        "description": "The page number for pagination (starts from 1). Default is 1.",
        "default": 1
      }
    },
    "required": [
      "filters"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.profiles` | `array` | No | — | — |
| `result.data.profiles[].name` | `string` | No | — | Full name of the individual. |
| `result.data.profiles[].location` | `string` | No | — | Current location of the individual. |
| `result.data.profiles[].linkedin_profile_url` | `string` | No | — | URL of the individual's LinkedIn profile. Format: `uri`. |
| `result.data.profiles[].linkedin_profile_urn` | `string` | No | — | Unique identifier for the LinkedIn profile. |
| `result.data.profiles[].default_position_title` | `string` | No | — | Title of the individual's current position. |
| `result.data.profiles[].default_position_company_linkedin_id` | `string` | No | — | LinkedIn ID of the company where the individual holds their default position. |
| `result.data.profiles[].default_position_is_decision_maker` | `boolean` | No | — | Indicates if the individual is a decision maker in their current position. |
| `result.data.profiles[].flagship_profile_url` | `string` | No | — | URL of the flagship LinkedIn profile. Format: `uri`. |
| `result.data.profiles[].profile_picture_url` | `string \| null` | No | — | URL of the individual's profile picture (can be null). Format: `uri`. |
| `result.data.profiles[].headline` | `string` | No | — | Professional headline of the individual. |
| `result.data.profiles[].summary` | `string` | No | — | Summary of the individual's professional experience. |
| `result.data.profiles[].num_of_connections` | `integer` | No | — | Number of LinkedIn connections the individual has. |
| `result.data.profiles[].related_colleague_company_id` | `integer` | No | — | LinkedIn ID of a related colleague's company. |
| `result.data.profiles[].skills` | `array` | No | — | List of skills possessed by the individual. |
| `result.data.profiles[].employer` | `array` | No | — | — |
| `result.data.profiles[].employer[].title` | `string` | No | — | Job title of the individual at the company. |
| `result.data.profiles[].employer[].company_name` | `string` | No | — | Name of the company. |
| `result.data.profiles[].employer[].company_linkedin_id` | `string` | No | — | LinkedIn ID of the company. |
| `result.data.profiles[].employer[].start_date` | `string` | No | — | Start date of employment. Format: `date-time`. |
| `result.data.profiles[].employer[].end_date` | `string \| null` | No | — | End date of employment (can be null if currently employed). Format: `date-time`. |
| `result.data.profiles[].employer[].description` | `string \| null` | No | — | Description of the role (can be null). |
| `result.data.profiles[].employer[].location` | `string` | No | — | Location of the company. |
| `result.data.profiles[].employer[].rich_media` | `array` | No | — | — |
| `result.data.profiles[].education_background` | `array` | No | — | — |
| `result.data.profiles[].education_background[].degree_name` | `string \| null` | No | — | Name of the degree obtained (can be null). |
| `result.data.profiles[].education_background[].institute_name` | `string` | No | — | Name of the educational institution. |
| `result.data.profiles[].education_background[].field_of_study` | `string` | No | — | Area of study. |
| `result.data.profiles[].education_background[].start_date` | `string` | No | — | Start date of education. Format: `date-time`. |
| `result.data.profiles[].education_background[].end_date` | `string` | No | — | End date of education. Format: `date-time`. |
| `result.data.profiles[].emails` | `array` | No | — | List of email addresses associated with the individual. |
| `result.data.profiles[].websites` | `array` | No | — | List of personal or professional websites. |
| `result.data.profiles[].twitter_handle` | `string \| null` | No | — | Twitter username of the individual (can be null). |
| `result.data.profiles[].languages` | `array` | No | — | List of languages spoken by the individual. |
| `result.data.profiles[].pronoun` | `string \| null` | No | — | Preferred pronouns of the individual (can be null). |
| `result.data.profiles[].current_title` | `string` | No | — | Current job title of the individual. |
| `result.data.total_display_count` | `string` | No | — | Short scale notation (like 1M+ or 1.5K) representing the total number of profiles available for the search. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "profiles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Full name of the individual."
                },
                "location": {
                  "type": "string",
                  "description": "Current location of the individual."
                },
                "linkedin_profile_url": {
                  "type": "string",
                  "description": "URL of the individual's LinkedIn profile.",
                  "format": "uri"
                },
                "linkedin_profile_urn": {
                  "type": "string",
                  "description": "Unique identifier for the LinkedIn profile."
                },
                "default_position_title": {
                  "type": "string",
                  "description": "Title of the individual's current position."
                },
                "default_position_company_linkedin_id": {
                  "type": "string",
                  "description": "LinkedIn ID of the company where the individual holds their default position."
                },
                "default_position_is_decision_maker": {
                  "type": "boolean",
                  "description": "Indicates if the individual is a decision maker in their current position."
                },
                "flagship_profile_url": {
                  "type": "string",
                  "description": "URL of the flagship LinkedIn profile.",
                  "format": "uri"
                },
                "profile_picture_url": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "URL of the individual's profile picture (can be null).",
                  "format": "uri"
                },
                "headline": {
                  "type": "string",
                  "description": "Professional headline of the individual."
                },
                "summary": {
                  "type": "string",
                  "description": "Summary of the individual's professional experience."
                },
                "num_of_connections": {
                  "type": "integer",
                  "description": "Number of LinkedIn connections the individual has."
                },
                "related_colleague_company_id": {
                  "type": "integer",
                  "description": "LinkedIn ID of a related colleague's company."
                },
                "skills": {
                  "type": "array",
                  "description": "List of skills possessed by the individual.",
                  "items": {
                    "type": "string"
                  }
                },
                "employer": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "title": {
                        "type": "string",
                        "description": "Job title of the individual at the company."
                      },
                      "company_name": {
                        "type": "string",
                        "description": "Name of the company."
                      },
                      "company_linkedin_id": {
                        "type": "string",
                        "description": "LinkedIn ID of the company."
                      },
                      "start_date": {
                        "type": "string",
                        "description": "Start date of employment.",
                        "format": "date-time"
                      },
                      "end_date": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "End date of employment (can be null if currently employed).",
                        "format": "date-time"
                      },
                      "description": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Description of the role (can be null)."
                      },
                      "location": {
                        "type": "string",
                        "description": "Location of the company."
                      },
                      "rich_media": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "description": "Media related to the job (currently empty)."
                        }
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "education_background": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "degree_name": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Name of the degree obtained (can be null)."
                      },
                      "institute_name": {
                        "type": "string",
                        "description": "Name of the educational institution."
                      },
                      "field_of_study": {
                        "type": "string",
                        "description": "Area of study."
                      },
                      "start_date": {
                        "type": "string",
                        "description": "Start date of education.",
                        "format": "date-time"
                      },
                      "end_date": {
                        "type": "string",
                        "description": "End date of education.",
                        "format": "date-time"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "emails": {
                  "type": "array",
                  "description": "List of email addresses associated with the individual.",
                  "items": {
                    "type": "string"
                  }
                },
                "websites": {
                  "type": "array",
                  "description": "List of personal or professional websites.",
                  "items": {
                    "type": "string"
                  }
                },
                "twitter_handle": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Twitter username of the individual (can be null)."
                },
                "languages": {
                  "type": "array",
                  "description": "List of languages spoken by the individual.",
                  "items": {
                    "type": "string"
                  }
                },
                "pronoun": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Preferred pronouns of the individual (can be null)."
                },
                "current_title": {
                  "type": "string",
                  "description": "Current job title of the individual."
                }
              },
              "additionalProperties": false
            }
          },
          "total_display_count": {
            "type": "string",
            "description": "Short scale notation (like 1M+ or 1.5K) representing the total number of profiles available for the search."
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `0.4` per pricing unit.

## Related documentation

* [CrustData V2 provider guide](https://deepline.com/docs/providers/crustdata-v2/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.