Company & Employee Enrichment API
Supercharge your product or your sales machine with our enrichment API for companies and employees
API Documentation
The Companies API is built using the REST architecture. Our routes accept request bodies encoded in the form format and return responses encoded in the JSON format. You can jump from one feature to another with the navigation menu on your left. Examples with real responses are provided on the right side of the page.
Of course, if you need help with anything or want to see additional features, feel free to reach us in the chatbox. We are usually quick to implement them.
Base URL
https://api.thecompaniesapi.com
Authentication
The Companies API uses API token to authenticate requests.
You can manage your API tokens in your settings or on the right side of this section.
Your API tokens carry many privileges, so keep them secure! Please do not share them in publicly accessible areas such as GitHub, client-side code, etc. Those authentication keys are permanent (they never expire). You can consider them safe for long-term purposes.
There are two ways to authenticate your HTTP requests to the API:
By adding an "Authorization" header. The "Authorization" header is formatted as such: "Authorization: Basic MY-API-TOKEN" (replace "MY-API-TOKEN" with one of yours).
or
By sending the API token as a "GET" parameter. Like this "?token=MY-API-TOKEN" (mostly used to quickly test a endpoint).
Please note that you can only use HTTPS to access the API. HTTP is not supported.
Your API tokens
To help you test all our endpoints in a click, your API token is included in all the endpoints below when you copy them.
Your API tokens
Create a new API token
You don't have any api tokens yet
Create an api token to start using the api.
Errors & Rate-Limiting
The Companies API uses conventional HTTP response codes to indicate the success or failure of an API request. Generally, Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted). Codes in the 5xx range indicate an error with our servers (these are rare).
Some 4xx errors that could be handled programmatically include an error code that briefly explains what went wrong.
We consider the credit system a rate-limit system by design. Some free API features such as the job titles, industries, and others have a rate limit security. Contact us with your use case if you plan to use them in a high volume.
Error object
error. codestring
For some errors that could be handled programmatically, a number indicating the error code reported.
error. messagestring
A message providing more details about the error.
error. typeenum
The type of error returned (see the list on your right).
Possible values
HTTP status code summary
200 - OKThe request was successful.
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter.
401 - UnauthorizedNo valid API token provided.
402 - Request FailedThe parameters were valid, but the request failed.
403 - ForbiddenThe API token doesn't have permission to perform the request.
404 - Not FoundThe requested resource doesn't exist.
409 - ConflictThe request conflicts with another request (perhaps due to using the same idempotent key).
429 - Too Many RequestsToo many requests hit the API too quickly. We recommend an exponential backoff of your requests.
500, 502, 503, 504 - Server ErrorsSomething went wrong on our end. These rare errors should be reported, but we catch them with Sentry and fix them as soon as they occur.
HTTP errors types summary
apiConnectionErrorFailure to connect to The Companies API.
apiErrorAPI errors cover any other type of problem (e.g., a temporary problem with The Companies API's servers) and are extremely uncommon.
authenticationErrorFailure to properly authenticate yourself in the request.
invalidRequestErrorInvalid request errors arise when your request has invalid parameters.
noCreditsRemainingYou have no remaining credits to make this request.
rateLimitErrorToo many requests hit the API too quickly. We recommend an exponential backoff of your requests.
Webhooks
The Companies API uses webhooks to notify you about changes or when an operation ends.
You can manage your webhooks on the right side of this section or in your settings.
Webhooks are helpful for receiving the results of our algorithms. For instance, when a new company you have requested has been scrapped or when we have found a new employee for one of your dynamic lists.
We are always looking for new ways to use webhooks. If you have any suggestion, please let us know.
Your Webhooks
Create a new webhook
You don't have any webhook yet
Create a webhook to receive a notification for the events you would like to track.
Companies
You will find all our features regarding our database of companies below.
Search companies with a specific condition or by name. Retrieve the profile of a particular business by providing its domain name or one of its social network URLs. Do you also need to get similar companies or even the email patterns they use? We got you covered.
An important concept to keep in mind is that we represent a company by its domain name (e.g., gucci.com). This is what we use as a unique key. That means that when we discover a new domain name, we consider it a new company.
Available endpoints
GET
https://api.thecompaniesapi.com/v1/companies
GET
https://api.thecompaniesapi.com/v1/companies/by-name
GET
https://api.thecompaniesapi.com/v1/companies/by-social
GET
https://api.thecompaniesapi.com/v1/companies/similar
GET
https://api.thecompaniesapi.com/v1/companies/:domain
GET
https://api.thecompaniesapi.com/v1/companies/:domain/email-patterns
Search companies0.25 Credit per company
0.25 Credit per company
Do you need to search companies located in a given country for a specific industry and that use a particular technology? Combine our conditions and create powerful search queries to identify them.
To help you create your first conditions, we have designed a generator below. We would also be glad to help you if you need it.
Query parameters
queryrequired
The conditions the companies must match.
Make sure this parameter is stringified and encoded.
Browse
GET
https://api.thecompaniesapi.com/v1/companies?query=%5B%7B%22attribute%22%3A%22industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%5D%7D%5D
domainsToExcludeoptional
A list of comma-separated domains to exclude from the results.
pageoptional
The page to fetch (default to 1).
searchoptional
An additionnal search query applied to the company name or domain.
searchFieldsoptional
Define the fields to search.
Possible values
simplifiedoptional
Return a simplified version of the companies (no credits deducted but limitation are applied on the free plan). It is useful for previewing the data before fetching the full version. Default to false.
Possible values
sizeoptional
The number of companies to be returned (between 1 and 100). Default to 10.
sortFieldoptional
The field to sort the results. Default to score.
Possible values
sortOrderoptional
The order to sort the results. Default to desc.
Possible values
Response
companiesarray
The companies that match your conditions.
metaobject
The metas information.
queryarray
The conditions the companies must match.
Endpoint
GET
https://api.thecompaniesapi.com/v1/companies
API response
Loading response...
Search companies by name1 Credit per call
1 Credit per call
Retrieve a company profile by providing the company name. You can use this endpoint if you need more information about the company, but be careful. Two companies can have the same name—for example, Bolt. That's why this feature can return multiple companies.
If you have a company's domain name, it's better to use it. We use it as a unique key in our database. See our endpoint below.
Query parameters
namerequired
The company name.
countriesoptional
The countries to filter the companies by. You can provide multiple countries separated by a comma. Default to all countries.
Possible values
ad
ae
af
ag
ai
al
am
ao
aq
ar
as
at
au
aw
ax
az
ba
bb
bd
be
exactWordsMatchoptional
If set to true, the company name must match the searched words. 'Bank of A' will not return Bank of America but 'Bank of' and 'Bank of America' will. Default to true.
sizeoptional
The number of companies to be returned (between 1 and 25). Default to 1.
sortFieldoptional
The field to sort the results. Default to score.
Possible values
sortOrderoptional
The order to sort the results. Default to desc.
Possible values
Response
companiesarray
The companies that match with the name.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/companies/by-name
API response
Loading response...
Enrich a company from a domain1 Credit per enrichment
1 Credit per enrichment
Enrich a company by sending us its domain name. The domain name is a better identifier than the company name because it is unique and less prone to typos.
We return more than 50 data points including the industries, the revenue, the technologies… If you need something we do not have yet, please let us know.
Query parameters
domainrequired
The company domain.
Response
company. alexaRanknumber
The company's Alexa rank.
company. businessTypestring
The company's business type.
Possible values
company. cityobject
The company's city.
company. codeNaicsstring
The company's NAICS code.
company. codeSicstring
The company's SIC code.
company. companiesAcquisitionsarray
The acquired companies.
company. companiesSubsidiariesarray
The subsidiary companies.
company. companiesSimilararray
The similar companies.
company. companyParentobject
The parent company.
company. continentobject
The company's continent.
company. countryobject
The company's country.
company. countyobject
The company's county.
company. descriptionstring
The company's description.
company. descriptionShortstring
The company's short description in one line.
company. domainstring
The company's domain.
company. domainAltsstring
The company's alternative domains (redirection).
company. domainNamestring
The company's domain name.
company. domainTldstring
The company's top level domain.
company. emailPatternsarray
The company's email patterns for employees.
company. idnumber
The company id.
company. industriesarray
The company's industries.
company. industryMainstring
The company's main industry (usually from LinkedIn).
company. logostring
The company's logo url.
company. monthlyVisitorsenum
The company's total monthly visitors.
Possible values
company. namestring
The company's name.
company. phoneNumberstring
The company's phone number.
company. revenueenum
The company's revenue.
Possible values
company. socialNetworksobject
The company's social networks.
company. stateobject
The company's state.
company. stockExchangestring
The company's stock exchange.
company. stockSymbolstring
The company's stock symbol.
company. technologiesarray
The technologies used by the company.
company. technologyCategoriesarray
The technologies' categories used by the company.
company. totalEmployeesenum
The company's total number of employees.
Possible values
company. totalEmployeesExactnumber
The company's exact number of employees.
company. yearFoundednumber
The company's year of foundation.
endpoint
GET
https://api.thecompaniesapi.com/v1/companies/gucci.com
API response
Loading response...
Enrich a company from a social network url (LinkedIn, Instagram, etc.)1 Credit per enrichment
1 Credit per enrichment
Retrieve the profile of a company by sending us a social network URL (see the list below for the ones we accept).
Multiple social URLs can be sent (i.e., both LinkedIn and YouTube), and we will check them in the order they are provided until we find a company that matches it.
Query parameters
crunchbaseoptional
The company's Crunchbase URL.
dribbbleoptional
The company's Dribbble URL.
facebookoptional
The company's Facebook URL.
githuboptional
The company's GitHub URL.
instagramoptional
The company's Instagram URL.
linkedinoptional
The company's LinkedIn URL. We handle both alpha urls (/company/gucci) and numeric ids (/company/6585).
pinterestoptional
The company's Pinterest URL.
snapchatoptional
The company's Snapchat URL.
tiktokoptional
The company's TikTok URL.
twitteroptional
The company's Twitter URL.
wellfoundoptional
The company's Wellfound URL.
youtubeoptional
The company's YouTube URL.
Response
company. alexaRanknumber
The company's Alexa rank.
company. businessTypestring
The company's business type.
Possible values
company. cityobject
The company's city.
company. codeNaicsstring
The company's NAICS code.
company. codeSicstring
The company's SIC code.
company. companiesAcquisitionsarray
The acquired companies.
company. companiesSubsidiariesarray
The subsidiary companies.
company. companiesSimilararray
The similar companies.
company. companyParentobject
The parent company.
company. continentobject
The company's continent.
company. countryobject
The company's country.
company. countyobject
The company's county.
company. descriptionstring
The company's description.
company. descriptionShortstring
The company's short description in one line.
company. domainstring
The company's domain.
company. domainAltsstring
The company's alternative domains (redirection).
company. domainNamestring
The company's domain name.
company. domainTldstring
The company's top level domain.
company. emailPatternsarray
The company's email patterns for employees.
company. idnumber
The company id.
company. industriesarray
The company's industries.
company. industryMainstring
The company's main industry (usually from LinkedIn).
company. logostring
The company's logo url.
company. monthlyVisitorsenum
The company's total monthly visitors.
Possible values
company. namestring
The company's name.
company. phoneNumberstring
The company's phone number.
company. revenueenum
The company's revenue.
Possible values
company. socialNetworksobject
The company's social networks.
company. stateobject
The company's state.
company. stockExchangestring
The company's stock exchange.
company. stockSymbolstring
The company's stock symbol.
company. technologiesarray
The technologies used by the company.
company. technologyCategoriesarray
The technologies' categories used by the company.
company. totalEmployeesenum
The company's total number of employees.
Possible values
company. totalEmployeesExactnumber
The company's exact number of employees.
company. yearFoundednumber
The company's year of foundation.
endpoint
GET
https://api.thecompaniesapi.com/v1/companies/by-social?linkedin=https://www.linkedin.com/company/gucci
API response
Loading response...
Count companies matching your queryFree
Free
Count the companies matching your conditions. Useful if you are building your own search engine for companies.
queryrequired
The conditions the companies must match.
Make sure this parameter is stringified and encoded.
Browse
GET
https://api.thecompaniesapi.com/v1/companies/count?query=%5B%7B%22attribute%22%3A%22industries%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22retail%22%5D%7D%5D
searchoptional
An additionnal search query applied to the company name or domain.
searchFieldsoptional
Define the fields to search.
Possible values
Response
countnumber
The number of companies matching the conditions.
Endpoint
GET
https://api.thecompaniesapi.com/v1/companies/count
API response
Loading response...
Find similar companies0.25 Credit per similar company
0.25 Credit per similar company
Send us one or more domains and we will return a list of similar companies.
This API feature is one of the most powerful. You can use it to find similar companies to your own, or to find companies that are similar to your customers. You can also use it to find companies that are similar to your competitors. The possibilities are endless.
Query parameters
domainsrequired
A list of domains separated by commas.
pageoptional
The page to fetch (default to 1).
sizeoptional
The number of similar companies to be returned (between 1 and 100). Default to 10.
Response
companiesarray
The similar companies for your list of domains.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/companies/similar?domains[]=gucci.com&page=1&size=10
API response
Loading response...
Find email patterns for a domain1 Credit
1 Credit
Send us a domain name and retrieve all the email patterns they use with the usage percentage.
We use this feature internally to prioritize the patterns when we want to guess and verify a business email address with external APIs. You can use this endpoint to decrease your API calls to tools like MailboxLayer or Debounce (and therefore your costs).
Query parameters
domainrequired
The company domain.
Response
patternsarray
The email patterns used.
endpoint
GET
https://api.thecompaniesapi.com/v1/companies/gucci.com/email-patterns
API response
Loading response...
Employees
We design algorithms to identify employees in real-time or enrich them when you need their email address or profile information. You will find all our features below.
If you need additional endpoints, feel free to contact us. We are usually fast to implement them.
Available endpoints
GET
https://api.thecompaniesapi.com/v1/employees
GET
https://api.thecompaniesapi.com/v1/employees/emails/discover
GET
https://api.thecompaniesapi.com/v1/employees/emails/enrich
Identify employees in real-time10 Credits per employee
10 Credits per employee
Search for employees with certain job titles inside a company. The company domain name is required, but job titles aren't. You can also use conditions the employees must match for more complicated queries (see query parameter).
You can also send the id of one of your lists to save the employees. If you don't have any list, you can create one with our endpoint to create a list.
You may wonder why our technology searches employees in real-time. From our experience (we were one of them), most services that rely on a database of employees take the risk of having outdated information. People leave from one job to another, get promoted, etc. This issue will never be one with us. The only downside is that it can take a few seconds to get the results.
Query parameters
countriesoptional
The country codes (comma-separated) to search for. If not defined, we will search for all countries.
Only countries with more than one million inhabitants are available.
Possible values
ae
af
al
am
ao
ar
at
au
az
ba
bd
be
bf
bg
bh
bi
bj
bo
br
bw
domainrequired
The company domain to search for employees (can also be a URL as we will extract the domain).
findEmailsoptional
If set to true, we will try to find the business email of the employees. This will make the response time slower.
We advise people to avoid using this parameter as it can make the response time very slow. Instead, use our endpoint to discover emails when you receive the employees (free of charge).
Possible values
hideCompanyoptional
If set to true, we will not attach the company information to the employees. This will make the response lighter. (default: false)
Possible values
jobTitlesoptional
The job titles (comma-separated) to search for. If not defined, we will search for all job titles.
listIdoptional
The id of the list to save the employees to.
pageoptional
The page to fetch (default: 1).
You must request the first page before fetching the next ones. As employees are found in real-time, we cannot know how many pages there are.
queryoptional
A more complex list of conditions the employees must match (if you want something more precise than the jobTitles and countries parameters).
Make sure this parameter is stringified and encoded.
Browse
GET
https://api.thecompaniesapi.com/v1/employees?query=%5B%7B%22attribute%22%3A%22jobTitles%22%2C%22operator%22%3A%22or%22%2C%22sign%22%3A%22equals%22%2C%22values%22%3A%5B%22marketing%22%5D%7D%5D&domain=gucci.com
sizeoptional
The number of employees to be returned (default to 100, max is 100).
Response
countriesarray
The country codes (comma-separated) to search for. If not defined, we will search for all countries.
employeesarray
The employees that match your conditions.
listobject
The list the employees were saved to.
metaobject
The metas information.
jobTitlesarray
The job titles (comma-separated) to search for. If not defined, we will search for all job titles.
queryarray
A more complex list of conditions the employees must match (if you want something more precise than the jobTitles and countries parameters).
endpoint
GET
https://api.thecompaniesapi.com/v1/employees
API response
Loading response...
Discover an employee's email5 Credits per email found
5 Credits per email found
Use our algorithms to find and verify an employee's email address. Send us the employee's first name, last name, middle name, and/or employee id, and we will do the rest.
We don't deduct credits when you provide the employee's id or when we can't figure out the email address.
Query parameters
domainoptional
The company's domain
employeeIdoptional
The employee's id
Credits are not deducted with this parameter.
firstNameoptional
The employee's first name
fullNameoptional
The employee's full name
lastNameoptional
The employee's last name
middleNameoptional
The employee's middle name
Response
emailstring
The discovered email.
emailDisposableboolean
Whether the email is disposable or not.
emailDomainstring
The email's domain.
emailFreeboolean
Whether the email is free or not.
emailPatternstring
The email's pattern.
emailStatusstring
The email's status.
Possible values
emailUsernamestring
The email's username.
Endpoint
GET
https://api.thecompaniesapi.com/v1/employees/emails/discover
API response
{email : "[email protected]" ,emailDisposable :false,emailDomain : "gucci.com" ,emailFree :false,emailPattern : "[F].[L]" ,emailStatus : "verified" ,emailUsername : "jay.gatsby" ,}
Enrich an employee from his/her email1 Credit per enrichment
1 Credit per enrichment
Send us a professional email, and we will enrich it with the company profile as well as data points about the employee (see list below).
If you need a specific data point, please ask us for it.
Query parameters
emailrequired
The email to enrich.
Response
companyobject
The company profile for the email.
emailstring
The email sent to enrich.
emailDisposableboolean
Whether the email is disposable or not.
emailFreeboolean
Whether the email is free or not.
endpoint
GET
https://api.thecompaniesapi.com/v1/employees/emails/enrich
API response
Loading response...
Industries
Search for specific industries and get information as the number of companies it contains.
We currently have over 3 million industries in our database. We can send you a file with our 100,000 most popular industries if you want to use it in your application.
Available endpoints
GET
https://api.thecompaniesapi.com/v1/industries
GET
https://api.thecompaniesapi.com/v1/industries/similar
Search industriesFree
Free
Search our industries database and get information such as the number of companies it contains. Results are sorted by "companies_count".
Query parameters
pageoptional
The page to fetch (default to 1).
searchoptional
An additionnal search query applied to the industry name.
sizeoptional
The number of industries to be returned (between 1 and 100). Default to 25.
Response
industriesarray
The industries that match your conditions.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/industries
API response
Loading response...
Find similar industriesFree
Free
Discover similar industries with our API. Identify related sectors and expand your business opportunities.
Query parameters
industriesrequired
The industries to compare with (max: 10).
pageoptional
The page to fetch (default to 1).
sizeoptional
The number of industries to be returned (between 1 and 100). Default to 25.
Response
industriesarray
The industries that match your conditions.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/industries/similar?industries[]=saas&size=10
API response
Loading response...
Job Titles
You will find all our features regarding our database of job titles below. Search or enrich job titles with the departments and the seniority levels. You can use these features to provide more context to your customers inside your CRM or to find specific employees with our algorithms.
If you need additional features, feel free to reach us in the chatbox. We are usually fast to implement them.
Available endpoints
GET
https://api.thecompaniesapi.com/v1/job-titles/enrich
Enrich a job title from its nameFree
Free
Send us a job title (e.g., chief marketing officer) and retrieve additional information like the departments and the seniority levels. We support the following languages: English, French, and Spanish.
Our database includes more than 165,000 job titles categorized in 70 departments and 10 seniority levels.
query
namerequired
The job title's name.
Response
jobTitle. departmentstring
The job title's department.
Possible values
jobTitle. departmentSecondarystring
The job title's secondary department.
Possible values
jobTitle. namestring
The job title's english name.
jobTitle. nameEsstring
The job title's spanish name.
jobTitle. nameFrstring
The job title's french name.
jobTitle. seniorityLevelstring
The job title's seniority level.
Possible values
endpoint
GET
https://api.thecompaniesapi.com/v1/job-titles/enrich
API response
Loading response...
Locations
The following endpoints let you search all our locations: cities, counties, states, countries, and continents.
ou can use them to filter our companies or target employees in a specific location.
Available endpoints
GET
https://api.thecompaniesapi.com/v1/locations/cities
GET
https://api.thecompaniesapi.com/v1/locations/counties
GET
https://api.thecompaniesapi.com/v1/locations/states
GET
https://api.thecompaniesapi.com/v1/locations/countries
GET
https://api.thecompaniesapi.com/v1/locations/continents
Search citiesFree
Free
Search our cities to filter companies or target employees in a specific location.
Query parameters
pageoptional
The page to fetch (default to 1).
searchoptional
An additionnal search query applied to the city name.
sizeoptional
The number of cities to be returned (between 1 and 20). Default to 10.
Response
citiesarray
The cities that match your conditions.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/locations/cities
API response
Loading response...
Search countiesFree
Free
Search our counties to filter companies or target employees in a specific location.
Query parameters
pageoptional
The page to fetch (default to 1).
searchoptional
An additionnal search query applied to the county name.
sizeoptional
The number of counties to be returned (between 1 and 20). Default to 10.
Response
countiesarray
The counties that match your conditions.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/locations/counties
API response
Loading response...
Search statesFree
Free
Search our states to filter companies or target employees in a specific location.
Query parameters
pageoptional
The page to fetch (default to 1).
searchoptional
An additionnal search query applied to the state name.
sizeoptional
The number of states to be returned (between 1 and 20). Default to 10.
Response
statesarray
The states that match your conditions.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/locations/states
API response
Loading response...
Search countriesFree
Free
Search our countries to filter companies or target employees in a specific location.
Query parameters
pageoptional
The page to fetch (default to 1).
searchoptional
An additionnal search query applied to the country name.
sizeoptional
The number of countries to be returned (between 1 and 20). Default to 10.
Response
countriesarray
The countries that match your conditions.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/locations/countries
API response
Loading response...
Search continentsFree
Free
Search our continents to filter companies or target employees in a specific location.
Query parameters
pageoptional
The page to fetch (default to 1).
searchoptional
An additionnal search query applied to the continent name.
sizeoptional
The number of continents to be returned (between 1 and 20). Default to 10.
Response
continentsarray
The continents that match your conditions.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/locations/continents
API response
Loading response...
Lists
Companies and employees can be saved in your lists. The following endpoints let you retrieve your lists and deal with the companies and employees that belong to them.
Available endpoints
GET
https://api.thecompaniesapi.com/v1/lists
POST
https://api.thecompaniesapi.com/v1/lists
GET
https://api.thecompaniesapi.com/v1/lists/:listId/companies
GET
https://api.thecompaniesapi.com/v1/lists/:listId/employees
Fetch your listsFree
Free
This endpoint allows you to retrieve the lists that belong to your team.
Query parameters
pageoptional
The page to fetch (default: 1).
sizeoptional
The number of lists to be returned (between 1 and 100). Default to 10.
typeoptional
The type of lists to retrieve.
Possible values
Response
listsarray
The lists that belong to your team.
metaobject
The metas information.
Endpoint
GET
https://api.thecompaniesapi.com/v1/lists
API response
{data :[{analytics :{ … },companyList : null ,createdAt : "2022-04-01T13:07:14.000+00:00" ,dynamic :false,id :4246,imported :false,integrations :[ … ],invisible :false,name : "French NodeJS Companies" ,processActive :false,processInitialized :true,processingAt : "2022-04-01T13:07:15.000+00:00" ,query :[ … ],type : "companies" ,},{analytics :{ … },companyList :{ … },createdAt : "2022-02-22T07:23:53.000+00:00" ,dynamic :false,id :3838,imported :false,integrations :[ … ],invisible :false,name : "Edtech Ceos & Founders" ,processActive :false,processInitialized :true,processingAt : "2022-02-22T07:23:53.000+00:00" ,query :[ … ],type : "employees" ,},{analytics :{ … },companyList : null ,createdAt : "2022-02-22T07:23:52.000+00:00" ,dynamic :false,id :3837,imported :false,integrations :[ ] ,invisible :false,name : "Edtech Companies" ,processActive :false,processInitialized :true,processingAt : "2022-02-22T07:23:53.000+00:00" ,query :[ … ],type : "companies" ,},],meta :{currentPage :1,firstPage :1,lastPage :1,perPage :10,total :4,},}
Create a list of companies or employeesFree
Free
This endpoint allows you to create a list of companies or employees.
Query parameters
dynamicoptional
Whether the list is dynamic or not. If set to true, the list will be updated automatically when new companies or employees are added to the database.
Possible values
namerequired
The name of the list.
typerequired
The type of list to create.
Possible values
Response
list. analyticsobject
The analytics of the list.
list. companyListobject
The associated company list when there is one.
list. createdAtdate
When the list was created.
list. dynamicboolean
Whether the list is dynamic or static.
list. idnumber
The id of the list.
list. importedboolean
Whether the list has been imported.
list. integrationsarray
The integrations associated with the list.
list. invisibleboolean
Whether the list is invisible (for internal use).
list. namestring
The name of the list
list. processActiveboolean
The process active status of the list (for internal use).
list. processInitializedboolean
The process initialized flag (for internal use).
list. processingAtdate
When the list is being processed.
list. queryarray
The query used to generate the list.
list. typestring
The type of the list.
Possible values
Endpoint
POST
https://api.thecompaniesapi.com/v1/lists
API response
{analytics :{ … },companyList : null ,createdAt : "2022-04-01T13:07:14.000+00:00" ,dynamic :false,id :4246,imported :false,integrations :[ ] ,invisible :false,name : "French NodeJS Companies" ,processActive :false,processInitialized :true,processingAt : "2022-04-01T13:07:15.000+00:00" ,query :[ ] ,type : "companies" ,}
Fetch companies in your listFree
Free
This endpoint allows you to fetch companies in your lists.
Query parameters
pageoptional
The page to fetch (default to 1).
sizeoptional
The number of companies to be returned (between 1 and 100). Default to 10.
Response
companiesarray
The companies that belong to your list.
metaobject
The metas information.
Endpoint
GET
https://api.thecompaniesapi.com/v1/lists/1234/domains
API response
{data :[{alexaRank :55726,businessType : null ,city :{ … },codeNaics : "334" ,codeSic : "737" ,country :{ … },description : "Blade was created in 2015 to design and develop a new type of Cloud computers, with a simple vision: Computer power should be mutualized. \\Tablets, smartphones and other connected devices have redefined our relationship to computing. Yet we struggle to move our contents and applications seamlessly across our devices. Cloud computing has fostered major evolutions in the way we use technology. Yet our PCs remain idle on our desks most of the time. \\This is poised to change. \\In the future, computer power will be allocated smartly. Our computers will be in the cloud. And we will be able to access them from any device. \\We want to be at the forefront of this revolution. \\Blade employs a team of passionate, highly skilled developers, as well as experts in business, law, marketing and distribution, and gaming. If you would like to know more about our company, please feel free to call us, or even stop by our office. We will be delighted to offer you coffee, and tell you more about our business." ,domain : "shadow.tech" ,domainAlts :[ ] ,domainName : "shadow" ,domainTld : "tech" ,emailPatterns :[ … ],id :20035,industries :[ … ],industryMain : "software" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/shadow.tech.jpg" ,monthlyVisitors : "1m-10m" ,name : "Blade - Shadow" ,phoneNumber : "(888) 890-6714" ,revenue : "1m-10m" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "50-200" ,yearFounded :2015,},{alexaRank :602519,businessType : null ,city :{ … },codeNaics : "54199" ,codeSic : "7299" ,country :{ … },description : "Cocolis.fr favorise les pratiques économes, écologiques et sociales en mettant en relation les particuliers qui ont besoin d'envoyer un objet et ceux qui ont de la place dans leur coffre ou dans leur valise. Les uns payent leur envoi jusqu'à 80% moins cher et les autres remboursent une partie de leurs frais de transport, tout en rendant service." ,domain : "cocolis.fr" ,domainAlts :[ ] ,domainName : "cocolis" ,domainTld : "fr" ,emailPatterns :[ … ],id :3992518,industries :[ … ],industryMain : "internet" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/cocolis.fr.jpg" ,monthlyVisitors : "10k-50k" ,name : "Cocolis" ,phoneNumber : "+33 6 68 03 06 94" ,revenue : "under-1m" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "1-10" ,yearFounded :2015,},{alexaRank :26730,businessType : null ,city :{ … },codeNaics : "54151" ,codeSic : "737" ,country :{ … },description : "Doctissimo.fr est le premier portail dédié au bien-être et à la santé destiné au grand public\Doctissimo.fr est le premier portail dédié au bien-être et à la santé destiné au grand public\Doctissimo.fr est le premier portail dédié au bien-être et à la santé destiné au grand public\Doctissimo.fr est le premier portail dédié au bien-être et à la santé destiné au grand public" ,domain : "doctissimo.fr" ,domainAlts :[ ] ,domainName : "doctissimo" ,domainTld : "fr" ,emailPatterns :[ … ],id :3264,industries :[ … ],industryMain : "web" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/doctissimo.fr.jpg" ,monthlyVisitors : "10m-50m" ,name : "Doctissimo" ,phoneNumber : "33 1 41 34 99 00" ,revenue : null ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "50-200" ,yearFounded :2000,},{alexaRank :315076,businessType : null ,city :{ … },codeNaics : "453" ,codeSic : "59" ,country :{ … },description : "BUT, une enseigne qui a le vent en poupe\\Créé en 1972, BUT possède aujourd'hui le plus dense réseau de magasins de mobilier, de décoration, de literie, de cuisine, d'électroménager et d'image et son en France. L'enseigne compte plus de 300 magasins répartis sur l'ensemble du territoire et déclinés sous trois formats : BUT, BUT CITY (concept citadin) et BUT COSY (concept rurbain).\Chaque jour, plus de 7000 salariés contribuent à faire de BUT un référent incontournable de la distribution des biens d'équipement du foyer.\De la cuisine avec une expertise sans cesse réaffirmée au salon ou à la chambre, de la décoration avec des collections conçues par des designers et renouvelées chaque année à l'électroménager ou l'électroloisir avec un large choix de produits, l'enseigne s'attache depuis toujours à répondre aux envies, aux besoins et aux budgets de chacun.\Depuis 7 années consécutives, BUT affiche une progression de ses parts de marché atteignant 13,1%. L'enseigne est aujourd'hui n°3 sur le marché du meuble." ,domain : "but.fr" ,domainAlts :[ ] ,domainName : "but" ,domainTld : "fr" ,emailPatterns :[ … ],id :437253,industries :[ … ],industryMain : "retail" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/but.fr.jpg" ,monthlyVisitors : "50k-100k" ,name : "BUT" ,phoneNumber : "+33 1 64 61 26 26" ,revenue : "200m-1b" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "500-1k" ,yearFounded :1972,},{alexaRank :631114,businessType : null ,city :{ … },codeNaics : "54199" ,codeSic : "7299" ,country :{ … },description : "L'aventure de Tediber a démarré fin 2015. \\Les quatre co-fondateurs, Julien Sylvain, entrepreneur, Juan Pablo Naranjo et Jean-Christophe Orthlieb designers et Aude du Colombier ex-Directrice Marketing de Google France ont une ambition toute simple : changer la vie de milliers de gens, en rendant accessible à tous, facilement et simplement un incroyable matelas. \\En quelques mois la jeune start-up française a révolutionné le marché opaque et compliqué du matelas : En vendant, exclusivement sur www.tediber.com, sans intermédiaires et à un prix juste, un modèle unique de très haute qualité, fabriqué en Belgique et disponible en différentes tailles. Combinant le meilleur de trois technologies - du latex micro-perforé, de la mousse à mémoire de forme et de la mousse haute résilience Tediber, le matelas Tediber est le seul matelas ferme et accueillant à la fois, conçu pour s'adapter à tous les dormeurs. \Il est livré gratuitement en express, comprimé et roulé dans sa boite, avec 100 nuits d'essai. Portée par un bouche à oreille extrêmement positif, avec plus de 7600 avis clients sur son site et une excellente note de satisfaction de 4.7/5, la start-up a déjà vendu plus de 30.000 matelas.\\Tediber qui a réalisé une levée de fonds auprès de 360 Capital Partners en mai 2016 et s'est lancé fin décembre, en Espagne et en Italie, ambitionne de réaliser 25M€ de chiffre d'affaire en 2017 et de devenir la marque lifestyle online de référence en Europe dans l'univers du sommeil et du bien-être. Depuis janvier 2017, Tediber a lancé trois nouveaux produits : l'oreiller, la couette et Tedi l'incroyable petit matelas pour enfants, tous designés et fabriqués en France. En avril 2017, la start-up a ouvert son showroom, 1 bis Cité Paradis, dans ses bureaux à Paris.\" ,domain : "tediber.com" ,domainAlts :[ ] ,domainName : "tediber" ,domainTld : "com" ,emailPatterns :[ … ],id :735339,industries :[ … ],industryMain : "ecommerce" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/tediber.com.jpg" ,monthlyVisitors : "10k-50k" ,name : "Tediber" ,phoneNumber : "+33 1 86 95 47 10" ,revenue : "1m-10m" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "10-50" ,yearFounded :2015,},{alexaRank :344626,businessType : null ,city :{ … },codeNaics : "522293" ,codeSic : "6111" ,country :{ … },description : "Société familiale et indépendante, FAMILLE MARY crée en 1921 par Jean MARY, au moulin de Beau Rivage en Anjou, entre Nantes et Angers, est dirigée depuis 2000 par Benoit MARY. \Récoltant sélectionneur de Miels depuis 3 générations, avec ses 1200 ruches sur le Val de Loire, cette PME conçoit, fabrique et distribue 150 produits naturels à base de trésors des abeilles et plantes, avec une offre d'alimentation fonctionnelle et gourmande, les compléments alimentaires et la diététique à base de Gelée Royale bio, et les Cosmétiques bio à base de miel et gelée royale . \En vente directe via notre réseau de magasins et Vente à distance, retrouvez les marques Famille Mary® et Abellie®. En réseaux spécialisés, Meltonic® (sports, runnings et cyclo), et Secrets de Ruche® (magasins bio). Depuis 2015, Famille Mary soutient la filière apicole Française, avec « Merci pour les Abeille » en reversant 1% de son chiffre d'affaires de miel à l'Union Nationale de l'Apiculture Française*. \Son développement s'est toujours accompagné de la volonté de concilier économie et éthique au sein d'une démarche environnementale et sociétale. « Notre mission est de contribuer à l'équilibre de vie grâce aux abeilles, en respectant la planète, car sans les abeilles, notre entreprise est coupée de ses vivres ». \Benoit MARY - Président" ,domain : "famillemary.fr" ,domainAlts :[ ] ,domainName : "famillemary" ,domainTld : "fr" ,emailPatterns :[ … ],id :912997,industries :[ … ],industryMain : "ecommerce" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/famillemary.fr.jpg" ,monthlyVisitors : "50k-100k" ,name : "Famille Mary" ,phoneNumber : "+33 2 41 55 35 79" ,revenue : "10m-50m" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "50-200" ,yearFounded :1921,},{alexaRank :109179,businessType : null ,city :{ … },codeNaics : "53" ,codeSic : "65" ,country :{ … },description : "Rhinov est une start-up qui met la technologie 3D au service de la décoration d'intérieur. Graphistes 3D, designers d'espace, ingénieurs en informatique et décorateurs travaillent à la réalisation de projets d'aménagements virtuels. \\Rhinov s'adresse à une clientèle de particuliers en manque d'inspiration déco mais également aux professionnels de l'immobilier en recherche de valorisation de biens. \\Rhinov c'est aussi une équipe jeune, dynamique et motivée qui ne cesse de s'agrandir. Alors rejoins-nous !\\www.rhinov.fr" ,domain : "rhinov.fr" ,domainAlts :[ ] ,domainName : "rhinov" ,domainTld : "fr" ,emailPatterns :[ … ],id :1034138,industries :[ … ],industryMain : "real-estate" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/rhinov.fr.jpg" ,monthlyVisitors : "500k-1m" ,name : "Rhinov" ,phoneNumber : "+33 9 72 45 52 39" ,revenue : "1m-10m" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "10-50" ,yearFounded :2013,},{alexaRank :729,businessType : null ,city :{ … },codeNaics : "4483" ,codeSic : "594" ,country :{ … },description : "For more than 150 years, men and women at Louis Vuitton have shared the same spirit of excellence and passion, reaffirming their expertise every day, the world over. With us, every career is a journey, filled with excitement and challenge, desire and daring. There is no better way to reveal your potential. Explore, develop, innovate, create... Every journey is unique. Today, Louis Vuitton invites you to discover your own." ,domain : "louisvuitton.com" ,domainAlts :[ ] ,domainName : "louisvuitton" ,domainTld : "com" ,emailPatterns :[ … ],id :2147,industries :[ … ],industryMain : "fashion" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/louisvuitton.com.jpg" ,monthlyVisitors : "500m-1b" ,name : "Louis Vuitton" ,phoneNumber : "(207) 998-6286" ,revenue : "over-1b" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "over-10k" ,yearFounded :1854,},{alexaRank :528153,businessType : null ,city :{ … },codeNaics : "54151" ,codeSic : "737" ,country :{ … },description : "Based in London, New York, Mexico, Lagos and Paris, Konbini® is a new generation media platform bringing Millennials together since 2008. Konbini built a community around its 100% pop culture angle, before progressively expanding to include news and society topics. Now with over 80 million unique visitors and more than 2.5 million Facebook followers, Konbini's success is proof that people under 30 have a voracious appetite for news and culture." ,domain : "konbini.com" ,domainAlts :[ ] ,domainName : "konbini" ,domainTld : "com" ,emailPatterns :[ … ],id :15466,industries :[ … ],industryMain : "marketing" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/konbini.com.jpg" ,monthlyVisitors : "10k-50k" ,name : "Konbini" ,phoneNumber : "33 1 42 77 93 61" ,revenue : "1m-10m" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "50-200" ,yearFounded :2008,},{alexaRank :32195,businessType : null ,city :{ … },codeNaics : null ,codeSic : null ,country :{ … },description : "World renowned in jewellery and prestige watchmaking, Cartier has combined expertise and excellence since 1847.\Cartier has made its creations into legends, with a team of men and women who make their passion their career.\If you would like to live your passion as part of Cartier, please see the career opportunities we offer." ,domain : "cartier.com" ,domainAlts :[ ] ,domainName : "cartier" ,domainTld : "com" ,emailPatterns :[ … ],id :32826,industries :[ … ],industryMain : "shopping" ,logo : "https://thecompaniesapi.s3.fr-par.scw.cloud/images/domains/cartier.com.jpg" ,monthlyVisitors : "10m-50m" ,name : "Cartier" ,phoneNumber : "(800) 227-8437" ,revenue : "over-1b" ,socialNetworks :{ … },technologies :[ … ],technologyCategories :[ … ],totalEmployees : "5k-10k" ,yearFounded :1847,},],meta :{currentPage :1,firstPage :1,lastPage :178,perPage :10,total :1771,},}
Fetch employees in your listFree
Free
This endpoint allows you to fetch the employees in your lists.
Query parameters
pageoptional
The page to fetch (default to 1).
sizeoptional
The number of employees to be returned (between 1 and 100). Default to 10.
sortFieldoptional
The field to sort the results.
Possible values
sortOrderoptional
The order to sort the results.
Possible values
Response
employeesarray
The employees that belong to your list.
metaobject
The metas information.
endpoint
GET
https://api.thecompaniesapi.com/v1/lists/1234/employees
API response
The response is empty
We did not receive any data from the API. Contact us if you think this is an error.