> ## 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.

# Lemlist: Search People Database

> Search People Database. Lemlist Search People Database reference includes SDK V2 and CLI requests, input constraints, response fields, and Deepline cost.

Search People Database.

<Info>
  Tool ID: `lemlist_search_people_database`
</Info>

## 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.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'lemlist_search_people_database',
  {
    "filters": [
      {
        "filterId": "filter_123",
        "in": [
          "example"
        ],
        "out": [
          "example"
        ]
      }
    ],
    "page": 123,
    "size": 100
  },
);

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

### CLI

```bash theme={null}
deepline tools execute lemlist_search_people_database --input '{
  "filters": [
    {
      "filterId": "filter_123",
      "in": [
        "example"
      ],
      "out": [
        "example"
      ]
    }
  ],
  "page": 123,
  "size": 100
}' --json
```

## Example response

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

```json theme={null}
{
  "data": {
    "results": [
      {
        "lead_id": 123,
        "canonical_shorthand_name": "Example",
        "connections_count": 123
      }
    ],
    "total": 123,
    "took": 123
  }
}
```

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

## Input reference

This endpoint allows you to query our People database. To do so, you may use the following parameters: filters (required), page (optional), size (optional), and excludes (optional). Each filter should have the following properties: filterId (filter identifier), in (list of the values you want to include), and out (list of the values you want to exclude). To know which filters you are able to use, refer to the GET Filters section. The `department` filter accepts the following values: `Sales`, `Customer service`, `Engineering`, `Marketing`, `Operations`, `Human Resources`, `Finance / Legal / Admin`, `Other`.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.filters` | `array` | No | — | Array of filters (required) |
| `payload.page` | `integer` | No | — | Page (optional) Minimum: 1. |
| `payload.size` | `integer` | No | — | Size of the results, number between 1 and 100 (optional) Minimum: 1. Maximum: 100. |
| `payload.excludes` | `array` | No | — | Array of properties to exclude from the results (optional) |
| `payload.search` | `string` | No | — | Free-text query across common people fields (e.g., name, title, company, location) |

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

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "This endpoint allows you to query our People database. To do so, you may use the following parameters: filters (required), page (optional), size (optional), and excludes (optional). Each filter should have the following properties: filterId (filter identifier), in (list of the values you want to include), and out (list of the values you want to exclude). To know which filters you are able to use, refer to the GET Filters section. The `department` filter accepts the following values: `Sales`, `Customer service`, `Engineering`, `Marketing`, `Operations`, `Human Resources`, `Finance / Legal / Admin`, `Other`.",
    "properties": {
      "filters": {
        "type": "array",
        "description": "Array of filters (required)",
        "items": {
          "type": "object",
          "properties": {
            "filterId": {
              "type": "string",
              "description": "Filter identifier"
            },
            "in": {
              "type": "array",
              "description": "List of the values you want to include",
              "items": {
                "type": "string"
              }
            },
            "out": {
              "type": "array",
              "description": "List of the values you want to exclude",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        }
      },
      "page": {
        "type": "integer",
        "description": "Page (optional)",
        "minimum": 1
      },
      "size": {
        "type": "integer",
        "description": "Size of the results, number between 1 and 100 (optional)",
        "minimum": 1,
        "maximum": 100
      },
      "excludes": {
        "type": "array",
        "description": "Array of properties to exclude from the results (optional)",
        "items": {
          "type": "string"
        }
      },
      "search": {
        "type": "string",
        "description": "Free-text query across common people fields (e.g., name, title, company, location)"
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.results` | `array` | No | — | Results array |
| `result.data.results[].lead_id` | `integer` | No | — | Numeric identifier for the person in the People database |
| `result.data.results[].canonical_shorthand_name` | `string` | No | — | — |
| `result.data.results[].connections_count` | `integer` | No | — | — |
| `result.data.results[].country` | `string` | No | — | — |
| `result.data.results[].full_name` | `string` | No | — | — |
| `result.data.results[].education` | `array` | No | — | — |
| `result.data.results[].education[].activities_and_societies` | `string` | No | — | — |
| `result.data.results[].education[].created` | `string` | No | — | — |
| `result.data.results[].education[].date_from` | `string` | No | — | — |
| `result.data.results[].education[].date_to` | `string` | No | — | — |
| `result.data.results[].education[].deleted` | `string` | No | — | — |
| `result.data.results[].education[].description` | `string` | No | — | — |
| `result.data.results[].education[].id` | `string` | No | — | — |
| `result.data.results[].education[].last_updated` | `string` | No | — | — |
| `result.data.results[].education[].member_id` | `string` | No | — | — |
| `result.data.results[].education[].school_url` | `string` | No | — | Format: `uri`. |
| `result.data.results[].education[].subtitle` | `string` | No | — | — |
| `result.data.results[].education[].title` | `string` | No | — | — |
| `result.data.results[].experience_count` | `integer` | No | — | — |
| `result.data.results[].experiences` | `array` | No | — | — |
| `result.data.results[].experiences[].company_id` | `integer` | No | — | — |
| `result.data.results[].experiences[].company_description` | `string` | No | — | — |
| `result.data.results[].experiences[].company_employee_count` | `integer` | No | — | — |
| `result.data.results[].experiences[].company_followers_count` | `integer` | No | — | — |
| `result.data.results[].experiences[].company_founded` | `integer` | No | — | — |
| `result.data.results[].experiences[].company_headquarters_city` | `string` | No | — | — |
| `result.data.results[].experiences[].company_headquarters_country` | `string` | No | — | — |
| `result.data.results[].experiences[].company_industry` | `string` | No | — | — |
| `result.data.results[].experiences[].company_linkedin_url` | `string` | No | — | Format: `uri`. |
| `result.data.results[].experiences[].company_logo_url` | `string` | No | — | Format: `uri`. |
| `result.data.results[].experiences[].company_name` | `string` | No | — | — |
| `result.data.results[].experiences[].company_size` | `string` | No | — | — |
| `result.data.results[].experiences[].company_type` | `string` | No | — | — |
| `result.data.results[].experiences[].company_url` | `string` | No | — | — |
| `result.data.results[].experiences[].company_website_url` | `string` | No | — | Format: `uri`. |
| `result.data.results[].experiences[].revenue_bucket` | `string` | No | — | — |
| `result.data.results[].experiences[].company_domain` | `string` | No | — | — |
| `result.data.results[].experiences[].employees_count_growth` | `integer` | No | — | — |
| `result.data.results[].experiences[].last_funding_round_at` | `string` | No | — | — |
| `result.data.results[].experiences[].business_business_customer` | `string` | No | — | — |
| `result.data.results[].experiences[].current_exp_bucket` | `string` | No | — | — |
| `result.data.results[].experiences[].created` | `string` | No | — | — |
| `result.data.results[].experiences[].date_from` | `string` | No | — | — |
| `result.data.results[].experiences[].date_to` | `string` | No | — | — |
| `result.data.results[].experiences[].description` | `string` | No | — | — |
| `result.data.results[].experiences[].duration` | `string` | No | — | — |
| `result.data.results[].experiences[].id` | `string` | No | — | — |
| `result.data.results[].experiences[].last_updated` | `string` | No | — | — |

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

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

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "results": {
            "type": "array",
            "description": "Results array",
            "items": {
              "type": "object",
              "description": "A person record from lemlist's People database.",
              "properties": {
                "lead_id": {
                  "type": "integer",
                  "description": "Numeric identifier for the person in the People database"
                },
                "canonical_shorthand_name": {
                  "type": "string"
                },
                "connections_count": {
                  "type": "integer"
                },
                "country": {
                  "type": "string"
                },
                "full_name": {
                  "type": "string"
                },
                "education": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "activities_and_societies": {
                        "type": "string"
                      },
                      "created": {
                        "type": "string"
                      },
                      "date_from": {
                        "type": "string"
                      },
                      "date_to": {
                        "type": "string"
                      },
                      "deleted": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "id": {
                        "type": "string"
                      },
                      "last_updated": {
                        "type": "string"
                      },
                      "member_id": {
                        "type": "string"
                      },
                      "school_url": {
                        "type": "string",
                        "format": "uri"
                      },
                      "subtitle": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "experience_count": {
                  "type": "integer"
                },
                "experiences": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "company_id": {
                        "type": "integer"
                      },
                      "company_description": {
                        "type": "string"
                      },
                      "company_employee_count": {
                        "type": "integer"
                      },
                      "company_followers_count": {
                        "type": "integer"
                      },
                      "company_founded": {
                        "type": "integer"
                      },
                      "company_headquarters_city": {
                        "type": "string"
                      },
                      "company_headquarters_country": {
                        "type": "string"
                      },
                      "company_industry": {
                        "type": "string"
                      },
                      "company_linkedin_url": {
                        "type": "string",
                        "format": "uri"
                      },
                      "company_logo_url": {
                        "type": "string",
                        "format": "uri"
                      },
                      "company_name": {
                        "type": "string"
                      },
                      "company_size": {
                        "type": "string"
                      },
                      "company_type": {
                        "type": "string"
                      },
                      "company_url": {
                        "type": "string"
                      },
                      "company_website_url": {
                        "type": "string",
                        "format": "uri"
                      },
                      "revenue_bucket": {
                        "type": "string"
                      },
                      "company_domain": {
                        "type": "string"
                      },
                      "employees_count_growth": {
                        "type": "integer"
                      },
                      "last_funding_round_at": {
                        "type": "string"
                      },
                      "business_business_customer": {
                        "type": "string"
                      },
                      "current_exp_bucket": {
                        "type": "string"
                      },
                      "created": {
                        "type": "string"
                      },
                      "date_from": {
                        "type": "string"
                      },
                      "date_to": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "duration": {
                        "type": "string"
                      },
                      "id": {
                        "type": "string"
                      },
                      "last_updated": {
                        "type": "string"
                      },
                      "location": {
                        "type": "string"
                      },
                      "member_id": {
                        "type": "string"
                      },
                      "order_in_profile": {
                        "type": "integer"
                      },
                      "title": {
                        "type": "string"
                      },
                      "title_normalized": {
                        "type": "string"
                      },
                      "main_in_profile": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "interests": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "interest": {
                        "type": "string"
                      },
                      "interest_id": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "languages": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "language": {
                        "type": "string"
                      },
                      "proficiency": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "last_updated": {
                  "type": "string"
                },
                "lead_industry": {
                  "type": "string"
                },
                "lead_linkedin_url": {
                  "type": "string",
                  "format": "uri"
                },
                "lead_logo_url": {
                  "type": "string",
                  "format": "uri"
                },
                "linkedin_short": {
                  "type": "string"
                },
                "location": {
                  "type": "string"
                },
                "skills": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "skill": {
                        "type": "string"
                      },
                      "skill_id": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "summary": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "lead_quality_score": {
                  "type": "integer"
                },
                "seniority": {
                  "type": "string"
                },
                "department": {
                  "type": "string"
                },
                "connections_count_bucket": {
                  "type": "string"
                },
                "years_of_exp_bucket": {
                  "type": "string"
                },
                "current_exp_company_name": {
                  "type": "string"
                },
                "geopoint": {
                  "type": "array",
                  "minItems": 2,
                  "maxItems": 2,
                  "items": {
                    "type": "number"
                  }
                },
                "_score": {
                  "type": "number"
                },
                "_id": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "total": {
            "type": "integer",
            "description": "Total number of results"
          },
          "took": {
            "type": "integer",
            "description": "Duration of the elastic-search query in milliseconds"
          },
          "page": {
            "type": "integer",
            "description": "Current page number"
          },
          "size": {
            "type": "integer",
            "description": "Size of the results (asked through parameters)"
          },
          "search": {
            "type": "string",
            "description": "Unique identifier of the current search"
          },
          "limitation": {
            "type": "integer",
            "description": "Remaining calls for the POST People database and POST Companies database (search is limited to a number of queries every 24 hours)"
          },
          "team": {
            "type": "string",
            "description": "Unique identifier of the current team"
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Lemlist provider guide](/docs/providers/lemlist/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)


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