Search Companies Database

Searches the companies database using filters, keywords, and pagination.

POST /database/companies

Search Companies Database

cURL

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;
}

200

{
  "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 [e-mail].",
      "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"

To know which filters you are able to use, refer to the GET Filters section.

If you need more details about the schema of the companies returned as a results array, refer to the GET Companies Schema section section.

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.

Show child attributes

page · integer

Page number for pagination (default: 1)

size · integer

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

Response

200

application/json

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

search · string

Search session identifier

limitation · integer

Result limitation applied

team · string

Team identifier