> ## 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 the Lemlist people database for prospects by filters such as job title, company and location. Includes SDK V2 examples, schemas, and cost.

Search the Lemlist people database for prospects by filters such as job title, company and location.

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

## 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(
  'lemlist_search_people_database',
  {
    "filters": [
      {
        "filterId": "filter_123",
        "in": [
          "example"
        ],
        "out": [
          "example"
        ]
      }
    ],
    "page": 123,
    "size": 100
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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 returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "results": [
      {
        "lead_id": 123,
        "canonical_shorthand_name": "Example",
        "connections_count": 123
      }
    ],
    "total": 123,
    "took": 123
  }
}
```

Use `deepline describe 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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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](https://deepline.com/docs/providers/lemlist/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.