Lemlist Developer Docs

Search Companies Database

curl --request POST \
  --url https://api.lemlist.com/api/database/companies \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "filterId": "currentCompanyTechnologies",
      "in": [
        "Postman"
      ],
      "out": [
        "Haskell"
      ]
    }
  ],
  "page": 1,
  "size": 2
}
'

import requests

url = "https://api.lemlist.com/api/database/companies"

payload = {
    "filters": [
        {
            "filterId": "currentCompanyTechnologies",
            "in": ["Postman"],
            "out": ["Haskell"]
        }
    ],
    "page": 1,
    "size": 2
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filters: [{filterId: 'currentCompanyTechnologies', in: ['Postman'], out: ['Haskell']}],
    page: 1,
    size: 2
  })
};

fetch('https://api.lemlist.com/api/database/companies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/database/companies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": [\n    {\n      \"filterId\": \"currentCompanyTechnologies\",\n      \"in\": [\n        \"Postman\"\n      ],\n      \"out\": [\n        \"Haskell\"\n      ]\n    }\n  ],\n  \"page\": 1,\n  \"size\": 2\n}"

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/database/companies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        [
                'filterId' => 'currentCompanyTechnologies',
                'in' => [
                                'Postman'
                ],
                'out' => [
                                'Haskell'
                ]
        ]
    ],
    'page' => 1,
    'size' => 2
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "results": [
    {
      "company_id": "88945664",
      "company_website_url": "http://acme-tech.example.com",
      "company_name": "Acme Technologies",
      "company_linkedin_url": "https://www.linkedin.com/company/acme-technologies",
      "last_updated": "2025-09-07 02:11:32 UTC",
      "company_headquarters_city": "Example City",
      "company_headquarters_country": "India",
      "company_logo_url": "https://example.com/logo1.png",
      "company_description": "Acme, established on Aug-2015 with the idea \"Make Your Imagination Come True\". Which means anyone who came up with their idea, we will give a closely realistic solutions to them. \nAcme Technologies is a new Generation Software Company, with young people with creative mind and immersive energy. We are a team of dedicated and highly skilled software professionals focused on providing world class IT solutions. We offer a variety of services in the area of:\nWebsite Designing & Development, Web Maintenance, E-Business Solutions, Android & iOS app, Blockchain Development, Software Development, Hosting Services.",
      "company_employee_count": "31",
      "company_type": "Public Company",
      "company_founded": "2015",
      "company_followers_count": "3958",
      "company_size": "11-50",
      "company_domain": "acme-tech.example.com",
      "employees_count_growth": -3,
      "techno_used_array": [
        "Apache HTTP Server",
        "Lightbox",
        "LinkedIn Sales Navigator",
        "Atlassian Jira",
        "LiteSpeed Cache",
        "Underscore.js",
        "Remix",
        "jsDelivr",
        "jQuery",
        "Google Fonts API",
        "Google Tag Manager",
        "X-Content-Type-Options",
        "Facebook",
        "PWA",
        "jQuery CDN",
        "ZURB Foundation",
        "HSTS",
        "WhatsApp Business",
        "X-XSS-Protection",
        "Google Analytics",
        "Flickity",
        "HTML",
        "LiteSpeed",
        "Ethereum",
        "Cloudinary",
        "OceanWP",
        "Goober",
        "jQuery Migrate",
        "Tailwind CSS",
        "Postman",
        "LinkedIn",
        "Webpack",
        "GSAP",
        "Essential Addons for Elementor",
        "Font Awesome",
        "Android",
        "PixelYourSite",
        "jQuery UI",
        "MUI",
        "IPFS",
        "Upwork",
        "cdnjs",
        "FlexSlider",
        "Elementor",
        "ZoomInfo",
        "Swiper",
        "Microsoft IIS",
        "Node.js",
        "Ethers",
        "Solidity",
        "React",
        "Priority Hints",
        "iOS",
        "OWL Carousel",
        "MySQL",
        "Facebook Pixel",
        "Open Graph",
        "Laravel",
        "Emotion",
        "Lucide",
        "PHP",
        "Blockchain",
        "Next.js",
        "RSS",
        "Google Maps",
        "Windows Server",
        "WordPress",
        "WPForms",
        "JavaScript",
        "Chainlink",
        "Apache",
        "Bootstrap"
      ],
      "business_business_customer": "B2B",
      "company_quality_score": "3",
      "company_industry": "Technology, Information and Media",
      "company_subindustry": "Technology, Information and Internet",
      "company_subsubindustry": "Software Development",
      "company_location": "123 Example Street, Suite 100, Example City, Example Country",
      "company_location_geopoint_array": [
        73.92,
        18.64
      ],
      "company_occ_lead": "60",
      "_score": 10.002095,
      "_id": "88945664"
    },
    {
      "company_id": "9903838",
      "company_website_url": "http://www.acme-care.example.com",
      "company_name": "Acme Care",
      "company_linkedin_url": "https://www.linkedin.com/company/acme-care",
      "last_updated": "2025-09-04 14:24:45 UTC",
      "company_headquarters_city": "San Francisco, California",
      "company_headquarters_country": "United States",
      "company_logo_url": "https://example.com/logo2.png",
      "company_description": "Acme Care provides an automated platform for team-based care management. To learn more, write us at contact@acme-care.example.com.",
      "company_employee_count": "33",
      "company_type": "Privately Held",
      "company_founded": "2013",
      "company_followers_count": "2651",
      "company_size": "11-50",
      "revenue_bucket": "$5M - $10M",
      "company_domain": "acme-care.example.com",
      "employees_count_growth": 6,
      "last_funding_round_at": "More than 6 months",
      "techno_used_array": [
        "Google Cloud",
        "Heap",
        "Envoy",
        "Google Cloud CDN",
        "X-Content-Type-Options",
        "Piwik",
        "WP Engine",
        "React",
        "cdnjs",
        "Fullstory",
        "Cloudflare Bot Management",
        "Twitter",
        "JSON-LD",
        "C3.js",
        "Python",
        "Google Analytics",
        "MediaElement.js",
        "SafeBase",
        "Emotion",
        "Nginx",
        "Atlassian Jira",
        "PayPal",
        "MUI",
        "Gravity Forms",
        "Zendesk",
        "MySQL",
        "Webpack",
        "PHP",
        "Facebook Pixel",
        "Google Fonts API",
        "OneTrust",
        "jQuery",
        "Gravatar",
        "Google Hosted Libraries",
        "Yoast SEO",
        "Jamf",
        "Cloudflare CDN",
        "Angular",
        "Postman",
        "Cloudflare",
        "HubSpot",
        "Java",
        "HTTP/3",
        "Moment.js",
        "X-XSS-Protection",
        "Open Graph",
        "JazzHR",
        "Workramp",
        "Algolia",
        "SSL.com",
        "Autoptimize",
        "Font Awesome",
        "oEmbed",
        "Bootstrap",
        "Facebook",
        "HSTS",
        "Ruby",
        "Twemoji",
        "WordPress",
        "Lightbox",
        "Adobe Fonts",
        "RequireJS",
        "Ruby on Rails",
        "Lodash",
        "reCAPTCHA",
        "LinkedIn Ads",
        "Hotjar",
        "Google Tag Manager"
      ],
      "business_business_customer": "B2B",
      "company_quality_score": "3",
      "company_industry": "Technology, Information and Media",
      "company_subindustry": "Technology, Information and Internet",
      "company_subsubindustry": "Software Development",
      "company_location": "San Francisco, California, US",
      "company_location_geopoint_array": [
        -122.42,
        37.78
      ],
      "company_occ_lead": "117",
      "_score": 9.972561,
      "_id": "9903838"
    }
  ],
  "total": 12102,
  "took": 17,
  "page": 1,
  "size": 2,
  "search": "lsh_8LBpZPgGpxGswp5G7",
  "limitation": 1998,
  "team": "tea_8QvkOiBfPdb2ZRhHi"
}

Bad team

The authentication you supplied is incorrect

No search found for this fromSearchId in this team and mode. Pass the searchId returned by a search of the same mode, or run the search again with filters

POST

database

companies

Search Companies Database

curl --request POST \
  --url https://api.lemlist.com/api/database/companies \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "filterId": "currentCompanyTechnologies",
      "in": [
        "Postman"
      ],
      "out": [
        "Haskell"
      ]
    }
  ],
  "page": 1,
  "size": 2
}
'

import requests

url = "https://api.lemlist.com/api/database/companies"

payload = {
    "filters": [
        {
            "filterId": "currentCompanyTechnologies",
            "in": ["Postman"],
            "out": ["Haskell"]
        }
    ],
    "page": 1,
    "size": 2
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    filters: [{filterId: 'currentCompanyTechnologies', in: ['Postman'], out: ['Haskell']}],
    page: 1,
    size: 2
  })
};

fetch('https://api.lemlist.com/api/database/companies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/database/companies")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": [\n    {\n      \"filterId\": \"currentCompanyTechnologies\",\n      \"in\": [\n        \"Postman\"\n      ],\n      \"out\": [\n        \"Haskell\"\n      ]\n    }\n  ],\n  \"page\": 1,\n  \"size\": 2\n}"

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/database/companies",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        [
                'filterId' => 'currentCompanyTechnologies',
                'in' => [
                                'Postman'
                ],
                'out' => [
                                'Haskell'
                ]
        ]
    ],
    'page' => 1,
    'size' => 2
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "results": [
    {
      "company_id": "88945664",
      "company_website_url": "http://acme-tech.example.com",
      "company_name": "Acme Technologies",
      "company_linkedin_url": "https://www.linkedin.com/company/acme-technologies",
      "last_updated": "2025-09-07 02:11:32 UTC",
      "company_headquarters_city": "Example City",
      "company_headquarters_country": "India",
      "company_logo_url": "https://example.com/logo1.png",
      "company_description": "Acme, established on Aug-2015 with the idea \"Make Your Imagination Come True\". Which means anyone who came up with their idea, we will give a closely realistic solutions to them. \nAcme Technologies is a new Generation Software Company, with young people with creative mind and immersive energy. We are a team of dedicated and highly skilled software professionals focused on providing world class IT solutions. We offer a variety of services in the area of:\nWebsite Designing & Development, Web Maintenance, E-Business Solutions, Android & iOS app, Blockchain Development, Software Development, Hosting Services.",
      "company_employee_count": "31",
      "company_type": "Public Company",
      "company_founded": "2015",
      "company_followers_count": "3958",
      "company_size": "11-50",
      "company_domain": "acme-tech.example.com",
      "employees_count_growth": -3,
      "techno_used_array": [
        "Apache HTTP Server",
        "Lightbox",
        "LinkedIn Sales Navigator",
        "Atlassian Jira",
        "LiteSpeed Cache",
        "Underscore.js",
        "Remix",
        "jsDelivr",
        "jQuery",
        "Google Fonts API",
        "Google Tag Manager",
        "X-Content-Type-Options",
        "Facebook",
        "PWA",
        "jQuery CDN",
        "ZURB Foundation",
        "HSTS",
        "WhatsApp Business",
        "X-XSS-Protection",
        "Google Analytics",
        "Flickity",
        "HTML",
        "LiteSpeed",
        "Ethereum",
        "Cloudinary",
        "OceanWP",
        "Goober",
        "jQuery Migrate",
        "Tailwind CSS",
        "Postman",
        "LinkedIn",
        "Webpack",
        "GSAP",
        "Essential Addons for Elementor",
        "Font Awesome",
        "Android",
        "PixelYourSite",
        "jQuery UI",
        "MUI",
        "IPFS",
        "Upwork",
        "cdnjs",
        "FlexSlider",
        "Elementor",
        "ZoomInfo",
        "Swiper",
        "Microsoft IIS",
        "Node.js",
        "Ethers",
        "Solidity",
        "React",
        "Priority Hints",
        "iOS",
        "OWL Carousel",
        "MySQL",
        "Facebook Pixel",
        "Open Graph",
        "Laravel",
        "Emotion",
        "Lucide",
        "PHP",
        "Blockchain",
        "Next.js",
        "RSS",
        "Google Maps",
        "Windows Server",
        "WordPress",
        "WPForms",
        "JavaScript",
        "Chainlink",
        "Apache",
        "Bootstrap"
      ],
      "business_business_customer": "B2B",
      "company_quality_score": "3",
      "company_industry": "Technology, Information and Media",
      "company_subindustry": "Technology, Information and Internet",
      "company_subsubindustry": "Software Development",
      "company_location": "123 Example Street, Suite 100, Example City, Example Country",
      "company_location_geopoint_array": [
        73.92,
        18.64
      ],
      "company_occ_lead": "60",
      "_score": 10.002095,
      "_id": "88945664"
    },
    {
      "company_id": "9903838",
      "company_website_url": "http://www.acme-care.example.com",
      "company_name": "Acme Care",
      "company_linkedin_url": "https://www.linkedin.com/company/acme-care",
      "last_updated": "2025-09-04 14:24:45 UTC",
      "company_headquarters_city": "San Francisco, California",
      "company_headquarters_country": "United States",
      "company_logo_url": "https://example.com/logo2.png",
      "company_description": "Acme Care provides an automated platform for team-based care management. To learn more, write us at contact@acme-care.example.com.",
      "company_employee_count": "33",
      "company_type": "Privately Held",
      "company_founded": "2013",
      "company_followers_count": "2651",
      "company_size": "11-50",
      "revenue_bucket": "$5M - $10M",
      "company_domain": "acme-care.example.com",
      "employees_count_growth": 6,
      "last_funding_round_at": "More than 6 months",
      "techno_used_array": [
        "Google Cloud",
        "Heap",
        "Envoy",
        "Google Cloud CDN",
        "X-Content-Type-Options",
        "Piwik",
        "WP Engine",
        "React",
        "cdnjs",
        "Fullstory",
        "Cloudflare Bot Management",
        "Twitter",
        "JSON-LD",
        "C3.js",
        "Python",
        "Google Analytics",
        "MediaElement.js",
        "SafeBase",
        "Emotion",
        "Nginx",
        "Atlassian Jira",
        "PayPal",
        "MUI",
        "Gravity Forms",
        "Zendesk",
        "MySQL",
        "Webpack",
        "PHP",
        "Facebook Pixel",
        "Google Fonts API",
        "OneTrust",
        "jQuery",
        "Gravatar",
        "Google Hosted Libraries",
        "Yoast SEO",
        "Jamf",
        "Cloudflare CDN",
        "Angular",
        "Postman",
        "Cloudflare",
        "HubSpot",
        "Java",
        "HTTP/3",
        "Moment.js",
        "X-XSS-Protection",
        "Open Graph",
        "JazzHR",
        "Workramp",
        "Algolia",
        "SSL.com",
        "Autoptimize",
        "Font Awesome",
        "oEmbed",
        "Bootstrap",
        "Facebook",
        "HSTS",
        "Ruby",
        "Twemoji",
        "WordPress",
        "Lightbox",
        "Adobe Fonts",
        "RequireJS",
        "Ruby on Rails",
        "Lodash",
        "reCAPTCHA",
        "LinkedIn Ads",
        "Hotjar",
        "Google Tag Manager"
      ],
      "business_business_customer": "B2B",
      "company_quality_score": "3",
      "company_industry": "Technology, Information and Media",
      "company_subindustry": "Technology, Information and Internet",
      "company_subsubindustry": "Software Development",
      "company_location": "San Francisco, California, US",
      "company_location_geopoint_array": [
        -122.42,
        37.78
      ],
      "company_occ_lead": "117",
      "_score": 9.972561,
      "_id": "9903838"
    }
  ],
  "total": 12102,
  "took": 17,
  "page": 1,
  "size": 2,
  "search": "lsh_8LBpZPgGpxGswp5G7",
  "limitation": 1998,
  "team": "tea_8QvkOiBfPdb2ZRhHi"
}

Bad team

The authentication you supplied is incorrect

No search found for this fromSearchId in this team and mode. Pass the searchId returned by a search of the same mode, or run the search again with filters

To know which filters you are able to use, refer to the GET Filters section.Filters of type slider (such as currentCompanyFounded) take one or more min|max ranges in in: two numbers joined by |, such as 2015|2024. Their out must stay empty. An out value, or a range in another format such as 2015-2024, answers 400 Parameter filters is invalid. To exclude a range, send the ranges around it in in. For example, ["1900|1989", "2001|2026"] excludes the companies founded from 1990 to 2000.

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

filters

object[]

Array of filter objects to narrow down search results. Each filter has a filterId and inclusion/exclusion criteria. Optional when fromSearchId is provided: each filter then replaces the saved filter with the same filterId, the other saved filters are kept, and an empty or absent filters replays the search as is.

Show child attributes

fromSearchId

string

Id of a previous Companies search of your team (not a People search): the search value returned by POST /database/companies (optional). The search is replayed with its saved filters. Each filter you pass in filters replaces the saved filter with the same filterId, the other saved filters are kept, and the merged filters are validated again as for a new search. With fromSearchId, filters is optional: an empty or absent filters replays the search as is.

A search id can be replayed for 6 months. A replay counts as one search in the daily search quota (see limitation in the response); only a paid part triggered elsewhere, such as LinkedIn post engagement, is not billed again.

If no search matches this id for your team and this mode, or the search is older than 6 months, the request is rejected with 404.

Pattern: ^lsh_[a-zA-Z0-9]{17}$

Example:

"lsh_ExAmPlE3wQ7nKd5Hs"

page

integer

Page number for pagination (default: 1)

size

integer

Number of results per page (default: 100, max: 500)

Response

Success

results

object[]

Show child attributes

total

integer

Total number of companies matching the search criteria

took

integer

Time taken for the search in milliseconds

page

integer

Current page number

size

integer

Number of results per page

string

Search session identifier. Reuse it as fromSearchId on POST /database/companies to replay this search; it stays valid for 6 months.

limitation

integer

Result limitation applied

team

string

Team identifier

Getting started

Popular Resources

Endpoints

Objects & Definitions

Search Companies Database

Authorizations

Body

Response