Skip to main content
POST
/
database
/
people
Search People Database
curl --request POST \
  --url https://api.lemlist.com/api/database/people \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "filterId": "country",
      "in": [
        "France"
      ],
      "out": []
    }
  ],
  "page": 1,
  "size": 25
}
'
{
  "results": [
    {
      "lead_id": 434482354,
      "canonical_shorthand_name": "gabrielcianelli",
      "connections_count": 500,
      "country": "France",
      "full_name": "Gabriel Cianelli",
      "education": [],
      "experience_count": 3,
      "experiences": [
        {
          "company_shorthand_name": "lemlist",
          "company_id": 11750398,
          "company_name": "lemlist",
          "company_website_url": "https://www.lemlist.com",
          "company_linkedin_url": "https://www.linkedin.com/company/lemlist",
          "company_employee_count": 151,
          "company_size": "51-200",
          "company_domain": "lemlist.com",
          "company_industry": "Technology, Information and Media",
          "title": "Account Executive",
          "title_normalized": "Account Executive",
          "date_from": "September 2025",
          "duration": "1 month",
          "location": "Ville de Paris, Île-de-France, France",
          "current_exp_bucket": "Less than 6 months"
        }
      ],
      "interests": [],
      "languages": [
        {
          "language": "Français",
          "proficiency": "Native or bilingual proficiency"
        },
        {
          "language": "Anglais",
          "proficiency": "Professional working proficiency"
        }
      ],
      "lead_linkedin_url": "https://www.linkedin.com/in/gabriel-cianelli-16447612b",
      "linkedin_short": "gabriel-cianelli-16447612b",
      "skills": [],
      "summary": "Passionate about helping sales teams book more meetings @lemlist",
      "headline": "Helping RevOps scale outbound @lemlist",
      "lead_quality_score": 3,
      "department": "Sales",
      "connections_count_bucket": "500+",
      "years_of_exp_bucket": "2 to 5 years",
      "location": "Paris, Ile-de-France, France",
      "state": "Ile-de-France",
      "current_exp_company_name": "lemlist",
      "_score": 21.294434,
      "_id": "434482354"
    }
  ],
  "total": 91,
  "took": 24,
  "page": 1,
  "size": 1,
  "search": "lsh_62r7ZDq9xJcKiAcjK",
  "limitation": 1999,
  "team": "tea_b4rMsi2trB42WyuWP"
}
This endpoint uses the People Database People object.
To know which filters you are able to use, refer to the GET Filters section.
This endpoint uses the People object. If you need more details about the schema of the people returned as a results array, refer to the GET People Schema section.
Route is available starting “Scale” plan

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Search criteria. Provide one or more filters and optionally control pagination with page/size and a free-text search.

​
filters
object[]

Array of filters (required)

​
page
integer

Page (optional)

Required range: x >= 1
​
size
integer

Size of the results, number between 1 and 100 (optional)

Required range: 1 <= x <= 100
​
excludes
string[]

Array of properties to exclude from the results (optional)

​
search
string

Free-text query across common people fields (e.g., name, title, company, location)

Response

Success

​
results
object[]

Results array

​
total
integer

Total number of results

​
took
integer

Duration of the elastic-search query in milliseconds

​
page
integer

Current page number

​
size
integer

Size of the results (asked through parameters)

​
search
string

Unique identifier of the current search

​
limitation
integer

Remaining calls for the POST People database and POST Companies database (search is limited to a number of queries every 24 hours)

​
team
string

Unique identifier of the current team