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.

​
Request body

  • filters: Array of filter objects
    • filterId: String identifier for the filter (use Get Database Filters to discover available filters)
    • in: Array of values to include
    • out: Array of values to exclude
  • page: Integer, page number (1-indexed). Default: 1
  • size: Integer, results per page (max 100). Default: 25
  • search: String, free-text query across common fields (e.g., name, title, company, location)
Example 
{
	"filters": [
		{
			"filterId": "country",
			"in": ["France"],
			"out": []
		},
        {
            "filterId": "currentCompany",
            "in": ["Lemlist"],
            "out": ["Lemwarm"]
        }
	],
	"page": 1,
	"size": 25
}

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[]
​
page
integer

Page number (1-indexed). Default: 1

Required range: x >= 1
​
size
integer

Number of results per page (max 100). Default: 25

Required range: 1 <= x <= 100
​
search
string

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

Response

Success

​
results
object[]
​
total
integer
​
took
integer
​
page
integer
​
size
integer
​
search
string
​
limitation
integer
​
team
string