The CompanyEnrich connector lets your AI agent act in each user's CompanyEnrich account. Each user connects their own CompanyEnrich access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 31 tools.
- Tools
- 31
- What they doRead · write · destructive
- 31 · 0 · 031 read0 write0 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the CompanyEnrich connection
In AgentKit > Connections, create a CompanyEnrich connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'companyenrich'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize CompanyEnrich:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'companyenrich_get_account',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "companyenrich"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize CompanyEnrich:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="companyenrich_get_account",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their CompanyEnrich credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcompanyenrich_autocomplete_companiesSuggest companies whose domain matches partial text.Read-onlyAutocomplete Companies
Suggest companies whose domain matches partial text. Free. Returns up to 10 companies, each with domain, name and logoUrl. Use this to turn a partial or misspelt company name into a domain before enriching it. Use companyenrich_search_companies for filtered search.
Inputs
querystringrequired- Partial company domain or name to complete. Example: strip
companyenrich_autocomplete_keywordsSuggest business keywords that match partial text.Read-onlyAutocomplete Keywords
Suggest business keywords that match partial text. Free. Returns an array of matching business keywords as strings. Use this to get exact values for the keywords filter of companyenrich_search_companies.
Inputs
querystringrequired- Partial text to complete. Example: fintech
companyenrich_autocomplete_positionsSuggest job titles that match partial text.Read-onlyAutocomplete Positions
Suggest job titles that match partial text. Free. Returns an array of matching job titles as strings. Use this to get exact values for the position_query filter of companyenrich_search_people.
Inputs
querystringrequired- Partial text to complete. Example: head of sa
companyenrich_autocomplete_technologiesSuggest technology names that match partial text.Read-onlyAutocomplete Technologies
Suggest technology names that match partial text. Free. Returns an array of matching technology names as strings. Use this to get exact values for the technologies filter of companyenrich_search_companies.
Inputs
querystringrequired- Partial text to complete. Example: salesfor
companyenrich_batch_enrich_companiesEnrich up to 50 companies from their domains in one call.Read-onlyBatch Enrich Companies
Enrich up to 50 companies from their domains in one call. Costs 1 credit per company enriched. Returns an array of company profiles, in the same shape as companyenrich_enrich_company_by_domain; domains that cannot be enriched are left out. Use this for a list of domains. Use companyenrich_enrich_company_by_domain for a single domain.
Inputs
domainsarrayrequired- Company domains to enrich, 1 to 50. Example: ["stripe.com", "notion.so"]
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
companyenrich_count_companiesCount the companies that match a set of search filters, without returning them.Read-onlyCount Companies
Count the companies that match a set of search filters, without returning them. Free. Returns the number of matching companies as a plain number. Use this to check or narrow filters before companyenrich_search_companies, which charges per result.
Inputs
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr listsarray- Only return companies saved in these CompanyEnrich company lists, by list ID (UUID). companyenrich_list_company_lists returns the IDs. Example: ["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
semantic_querystring- Natural-language description of the companies to find, up to 500 characters. Ranked by meaning rather than exact words. Example: developer tools for payments infrastructure
semantic_weightnumber- How much the semantic query counts against the other ranking factors, from 0 to 1. Defaults to 0.7; higher values favour semantic similarity. Only used with semantic_query. Example: 0.7
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_count_similar_companiesCount the lookalike companies for 1 to 10 seed domains and optional filters, without returning them.Read-onlyCount Similar Companies
Count the lookalike companies for 1 to 10 seed domains and optional filters, without returning them. Free. Returns the number of matching companies as a plain number. Use this before companyenrich_find_similar_companies, which charges 5 credits per result.
Inputs
domainsarrayrequired- Domains of 1 to 10 seed companies to find lookalikes for. Example: ["stripe.com"]
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr min_scorenumber- Minimum similarity score a result must reach, from 0 to 1. Omit to use the default cutoff. Example: 0.6
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
similarity_weightnumber- From -1 to 1, default 0. Higher values favour the most similar companies; lower values favour larger, more established companies. Example: 0.5
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
wait_for_enrichmentboolean- Whether to wait when a seed domain is not in CompanyEnrich's database yet. Defaults to true. Set false to return 404 straight away when any seed company is missing; the missing domains are then enriched in the background so a later retry succeeds.
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_enrich_company_by_domainEnrich one company from its website domain.Read-onlyEnrich Company by Domain
Enrich one company from its website domain. Costs 1 credit. Returns the company profile: id, name, website, type, industry and industries, categories, employee and revenue ranges, description, keywords, technologies, founded year, NAICS codes, location, funding and stock details, social profile URLs and logo URL. Use this when you know the domain; it is the most reliable lookup. Use companyenrich_enrich_company_by_properties when you only have a name or social profile URL, companyenrich_batch_enrich_companies for up to 50 domains at once, and companyenrich_get_company for a CompanyEnrich ID.
Inputs
domainstringrequired- Company website domain, without protocol or path. Example: stripe.com
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
wait_for_enrichmentboolean- Whether to wait for on-demand enrichment when the company is not in CompanyEnrich's database yet. Defaults to true. Set false to return stored data immediately; an unknown company then returns 404 without using credits and is enriched in the background so a later call can find it.
companyenrich_enrich_company_by_propertiesEnrich one company from its name or a social profile, when the domain is unknown.Read-onlyEnrich Company by Properties
Enrich one company from its name or a social profile, when the domain is unknown. Costs 1 credit. Returns the best-matching company profile, in the same shape as companyenrich_enrich_company_by_domain; 404 when nothing matches. Use this with a company name, LinkedIn URL or ID, or X/Twitter, Facebook, Instagram or YouTube URL. Use companyenrich_enrich_company_by_domain when you have the domain, since domain lookups are more reliable. Provide at least one of the inputs; more inputs give a more precise match.
Inputs
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
facebook_urlstring- Company Facebook page URL. Example: https://www.facebook.com/StripeHQ
instagram_urlstring- Company Instagram profile URL. Example: https://www.instagram.com/stripehq
linkedin_idstring- Numeric LinkedIn company ID. Example: 2135371
linkedin_urlstring- Company LinkedIn page URL. Example: https://www.linkedin.com/company/stripe
namestring- Company name. Example: Stripe
twitter_urlstring- Company X (Twitter) profile URL. Example: https://twitter.com/stripe
youtube_urlstring- Company YouTube channel URL. Example: https://www.youtube.com/@stripe
companyenrich_find_person_emailFind the work email address of one person by CompanyEnrich person ID (beta).Read-onlyFind Person Email
Find the work email address of one person by CompanyEnrich person ID (beta). Costs 10 credits for each newly found email. Returns a person summary, the domain used, a status (pending, found, not-found or unavailable) and, when found, the email and a certainty of unknown, medium, high or very-high. Use this after companyenrich_search_people to get contact details. A pending status means the lookup is still running; call again later.
Inputs
idintegerrequired- CompanyEnrich person ID, from the id field of a person result. Example: 123456789
domainstring- Company domain to resolve the email on. It must be one of the person's employers. Omit to try their current employers in seniority order. Example: stripe.com
companyenrich_find_similar_companiesFind lookalike companies for 1 to 10 seed domains, optionally narrowed by the same filters as company search.Read-onlyFind Similar Companies
Find lookalike companies for 1 to 10 seed domains, optionally narrowed by the same filters as company search. Costs 5 credits per company returned (minimum 5). Returns items (full company profiles), metadata.scores (similarity score per result), page, totalPages and totalItems; at most 100 companies per page. Use this to expand a target account list from your best customers. Use companyenrich_count_similar_companies to size it for free first, and companyenrich_search_companies to search by filters without seed companies.
Inputs
domainsarrayrequired- Domains of 1 to 10 seed companies to find lookalikes for. Example: ["stripe.com"]
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr min_scorenumber- Minimum similarity score a result must reach, from 0 to 1. Omit to use the default cutoff. Example: 0.6
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
pageinteger- Page number to return, starting at 1. page times page_size cannot exceed 10,000. Example: 2
page_sizeinteger- Results per page, 1 to 100. Example: 25
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
similarity_weightnumber- From -1 to 1, default 0. Higher values favour the most similar companies; lower values favour larger, more established companies. Example: 0.5
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
wait_for_enrichmentboolean- Whether to wait when a seed domain is not in CompanyEnrich's database yet. Defaults to true. Set false to return 404 straight away when any seed company is missing; the missing domains are then enriched in the background so a later retry succeeds.
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_get_accountGet the CompanyEnrich account's credit balance and plan capabilities.Read-onlyGet Account
Get the CompanyEnrich account's credit balance and plan capabilities. Free. Returns userId, credits (used and total) and capabilities: whether lists and preview endpoints are available, and the result limits for company search, async company search, people search and search terms. Use this to check remaining credits before a large search, or to check whether the plan includes the preview tools.
Inputs
This tool takes no inputs.
companyenrich_get_companyGet one company by its CompanyEnrich ID.Read-onlyGet Company
Get one company by its CompanyEnrich ID. Costs 1 credit. Returns the company profile, in the same shape as companyenrich_enrich_company_by_domain. Use this for an id returned by another CompanyEnrich tool. Use companyenrich_enrich_company_by_domain when you have a domain instead.
Inputs
idstringrequired- CompanyEnrich company ID (UUID), from the id field of any company result. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
companyenrich_get_company_workforceGet workforce insights for one company, by CompanyEnrich ID or domain.Read-onlyGet Company Workforce
Get workforce insights for one company, by CompanyEnrich ID or domain. Costs 5 credits. Returns the observed employee count, the employee range, headcount by department (engineering, sales, marketing and others) and monthly history of those counts. Use this to size teams or track hiring at one company. Use the workforce_size and workforce_growth filters of companyenrich_search_companies to find companies by headcount. Provide exactly one of id or domain.
Inputs
domainstring- Company website domain. Provide this or id, not both. Example: stripe.com
idstring- CompanyEnrich company ID (UUID). Provide this or domain, not both. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
companyenrich_get_countryGet one country by its two-letter ISO code.Read-onlyGet Country
Get one country by its two-letter ISO code. Free. Returns the country code, name, latitude and longitude; 404 for an unknown code. Use this to check a country code. Use companyenrich_search_countries to find a code by name.
Inputs
country_codestringrequired- Two-letter ISO 3166-1 alpha-2 country code. Example: DE
companyenrich_get_personGet one person by their CompanyEnrich person ID.Read-onlyGet Person
Get one person by their CompanyEnrich person ID. Costs 2 credits. Returns the person profile: name, position, seniority, department, location, social URLs, image URL and work experience. Use this for an id returned by companyenrich_search_people or companyenrich_lookup_person_by_email.
Inputs
idintegerrequired- CompanyEnrich person ID, a number from the id field of a person result. Example: 123456789
expandarray- Extra response fields to include. The only value is education, which adds the education history to each person and costs 1 extra credit per person. Omit to skip it. Example: ["education"]
companyenrich_get_person_educationGet the education history of one person by CompanyEnrich person ID.Read-onlyGet Person Education
Get the education history of one person by CompanyEnrich person ID. Costs 1 credit. Returns an array of schools with institution name, LinkedIn handle, degree, start year and end year; empty when none is known. Use this when you need only education. companyenrich_get_person with expand ["education"] returns the full profile plus education.
Inputs
idintegerrequired- CompanyEnrich person ID, from the id field of a person result. Example: 123456789
companyenrich_list_company_listsList the saved company lists in the CompanyEnrich account.Read-onlyList Company Lists
List the saved company lists in the CompanyEnrich account. Free. Returns items, each with id, name, createdAt, originalCount and type (Manual or Export). Use this to get list IDs for the lists filter of companyenrich_search_companies.
Inputs
This tool takes no inputs.
companyenrich_list_industriesList every industry CompanyEnrich uses to classify companies.Read-onlyList Industries
List every industry CompanyEnrich uses to classify companies. Free. Returns an array of industries, each with a name and its NAICS codes. Use this to find NAICS codes for the naics_codes filter of companyenrich_search_companies.
Inputs
This tool takes no inputs.
companyenrich_list_regionsList the world regions CompanyEnrich uses for location filters.Read-onlyList Regions
List the world regions CompanyEnrich uses for location filters. Free. Returns items, each with id, parentId, name and the country codes in the region. Use this to get region IDs for the regions filter of companyenrich_search_companies.
Inputs
This tool takes no inputs.
companyenrich_lookup_person_by_emailFind the person behind a work email address.Read-onlyLook Up Person by Email
Find the person behind a work email address. Costs 5 credits when a match is found. Returns the best-matching person profile: id, name, position, seniority, department, location, social URLs and work experience; 404 when there is no match. Use this to identify who an inbound email or lead belongs to. Use companyenrich_get_person when you have a CompanyEnrich person ID, and companyenrich_search_people to find people by role.
Inputs
emailstringrequired- Work email address of the person. Example: jane.doe@stripe.com
expandarray- Extra response fields to include. The only value is education, which adds the education history to each person and costs 1 extra credit per person. Omit to skip it. Example: ["education"]
companyenrich_preview_companiesPreview the top 25 companies for a set of search filters.Read-onlyPreview Companies
Preview the top 25 companies for a set of search filters. Free, but needs a CompanyEnrich Scale plan. Returns items (company summaries with id, name, domain, website, industry, description, keywords and logo URL), page, totalPages and totalItems. Use this to check that filters return the right kind of company before paying for companyenrich_search_companies.
Inputs
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr listsarray- Only return companies saved in these CompanyEnrich company lists, by list ID (UUID). companyenrich_list_company_lists returns the IDs. Example: ["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
semantic_querystring- Natural-language description of the companies to find, up to 500 characters. Ranked by meaning rather than exact words. Example: developer tools for payments infrastructure
semantic_weightnumber- How much the semantic query counts against the other ranking factors, from 0 to 1. Defaults to 0.7; higher values favour semantic similarity. Only used with semantic_query. Example: 0.7
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_preview_similar_companiesPreview the top 25 lookalike companies for 1 to 10 seed domains.Read-onlyPreview Similar Companies
Preview the top 25 lookalike companies for 1 to 10 seed domains. Free, but needs a CompanyEnrich Scale plan. Returns items (company summaries), metadata.scores, page, totalPages and totalItems. Use this to check lookalike quality before paying for companyenrich_find_similar_companies.
Inputs
domainsarrayrequired- Domains of 1 to 10 seed companies to find lookalikes for. Example: ["stripe.com"]
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr min_scorenumber- Minimum similarity score a result must reach, from 0 to 1. Omit to use the default cutoff. Example: 0.6
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
similarity_weightnumber- From -1 to 1, default 0. Higher values favour the most similar companies; lower values favour larger, more established companies. Example: 0.5
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
wait_for_enrichmentboolean- Whether to wait when a seed domain is not in CompanyEnrich's database yet. Defaults to true. Set false to return 404 straight away when any seed company is missing; the missing domains are then enriched in the background so a later retry succeeds.
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_scroll_companiesPage through company search results with a cursor, with no 10,000-result cap.Read-onlyScroll Companies
Page through company search results with a cursor, with no 10,000-result cap. Costs 1 credit per company returned (minimum 1). Returns items (full company profiles), nextCursor, previousCursor, totalItems, startIndex and metadata.totalMatching. Use this to walk a large result set. Use companyenrich_search_companies for numbered pages within the first 10,000 results.
Inputs
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
cursorstring- Cursor from the nextCursor field of the previous response. Omit for the first page. Send the same filters with every page. Example: eyJzIjpbMC45MiwiMTIzIl19
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr listsarray- Only return companies saved in these CompanyEnrich company lists, by list ID (UUID). companyenrich_list_company_lists returns the IDs. Example: ["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
page_sizeinteger- Results per page, 1 to 100. Example: 50
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
semantic_querystring- Natural-language description of the companies to find, up to 500 characters. Ranked by meaning rather than exact words. Example: developer tools for payments infrastructure
semantic_weightnumber- How much the semantic query counts against the other ranking factors, from 0 to 1. Defaults to 0.7; higher values favour semantic similarity. Only used with semantic_query. Example: 0.7
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_scroll_peoplePage through people search results with a cursor, with no 10,000-result cap.Read-onlyScroll People
Page through people search results with a cursor, with no 10,000-result cap. Costs 2 credits per person returned (minimum 2). Returns items (person profiles), nextCursor, previousCursor, totalItems, startIndex and metadata.totalMatching. Use this to walk a large result set. Use companyenrich_search_people for numbered pages within the first 10,000 results.
Inputs
at_current_company_afterstring- Only include people who joined their current company after this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
at_current_company_beforestring- Only include people who joined their current company before this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
at_current_position_afterstring- Only include people who started their current position after this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
at_current_position_beforestring- Only include people who started their current position before this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
company_filterobject- Find people at companies that match a company search or a lookalike search instead of listing domains. Set search to an object of company filters in the API's camelCase form (for example countries, employees, keywords, technologies), or similar to {"domains": [...]} to target lookalikes of those companies. Example: {"search": {"countries": ["US"], "employees": ["51-200"], "keywords": ["fintech"]}}
countriesarray- Two-letter ISO country codes of where the person is located. Example: ["US"]
cursorstring- Cursor from the nextCursor field of the previous response. Omit for the first page. Send the same filters with every page. Example: eyJzIjpbMC45MiwiMTIzIl19
departmentarray- Departments to include. Use a top-level department (c-suite, product-management, engineering-technical, design, education, finance, human-resources, information-technology, legal, marketing, medical-health, operations, sales, consulting) or a sub-department written as parent/child, such as sales/inside-sales or engineering-technical/software-development. Example: ["sales", "marketing/demand-generation"]
domainsarray- Domains of the companies the people currently work at, up to 2,500. Example: ["stripe.com"]
educationobject- Filter on schools attended: institutionNameQuery takes school name search terms and institutionLinkedinHandles takes the schools' LinkedIn handles. Example: {"institutionNameQuery": ["Stanford"]}
excludeobject- People to leave out. A person matching any of these is excluded. Supports positionQuery, countries, domains, seniority, department and education, in the same form as the include filters. Example: {"seniority": ["intern", "entry"], "domains": ["example.com"]}
expandarray- Extra response fields to include. The only value is education, which adds the education history to each person and costs 1 extra credit per person. Omit to skip it. Example: ["education"]
page_sizeinteger- Results per page, 1 to 100. Example: 50
position_queryarray- Job title search terms matched against each person's current position. A person matches if any term matches. companyenrich_autocomplete_positions suggests titles. Example: ["head of sales", "vp sales"]
querystring- Free-text query, up to 250 characters. CompanyEnrich documents it as matching the company name and domain. Example: stripe
seniorityarray- Seniority levels to include: owner, founder, c-suite, partner, vp, head, director, manager, senior, entry, intern. Example: ["vp", "director"]
companyenrich_scroll_similar_companiesPage through lookalike companies for 1 to 10 seed domains with a cursor.Read-onlyScroll Similar Companies
Page through lookalike companies for 1 to 10 seed domains with a cursor. Costs 5 credits per company returned (minimum 5). Returns items (full company profiles), nextCursor, previousCursor, totalItems, startIndex and metadata (similarity scores and totalMatching). Use this to walk a long lookalike list. Use companyenrich_find_similar_companies for numbered pages.
Inputs
domainsarrayrequired- Domains of 1 to 10 seed companies to find lookalikes for. Example: ["stripe.com"]
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
cursorstring- Cursor from the nextCursor field of the previous response. Omit for the first page. Send the same filters with every page. Example: eyJzIjpbMC45MiwiMTIzIl19
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr min_scorenumber- Minimum similarity score a result must reach, from 0 to 1. Omit to use the default cutoff. Example: 0.6
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
page_sizeinteger- Results per page, 1 to 100. Example: 50
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
similarity_weightnumber- From -1 to 1, default 0. Higher values favour the most similar companies; lower values favour larger, more established companies. Example: 0.5
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
wait_for_enrichmentboolean- Whether to wait when a seed domain is not in CompanyEnrich's database yet. Defaults to true. Set false to return 404 straight away when any seed company is missing; the missing domains are then enriched in the background so a later retry succeeds.
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_search_citiesSearch cities by name, optionally within given countries.Read-onlySearch Cities
Search cities by name, optionally within given countries. Free. Returns items (id, name, latitude, longitude), page, totalPages and totalItems; up to 100 per page. Use this to get the numeric IDs for the cities filter of companyenrich_search_companies.
Inputs
country_codesarray- Two-letter country codes to search within. Example: ["US"]
pageinteger- Page number, starting at 1. Each page holds up to 100 results. Example: 1
querystring- Name or part of a name, up to 30 characters. Example: san fran
companyenrich_search_companiesSearch CompanyEnrich's company database by text, meaning or filters such as location, size, revenue, industry, keywords, technologies and funding.Read-onlySearch Companies
Search CompanyEnrich's company database by text, meaning or filters such as location, size, revenue, industry, keywords, technologies and funding. Costs 1 credit per company returned (minimum 1). Returns items (full company profiles), page, totalPages and totalItems. Use this to build a list of target accounts; pages reach at most 10,000 results. Use companyenrich_count_companies to size a search for free first, companyenrich_scroll_companies to go past 10,000 results, and companyenrich_find_similar_companies to find lookalikes of known companies.
Inputs
categoryarray- Business model categories to include: b2b, b2c, b2g, e-commerce, media, service-provider, mobile, saas. Combine several with category_operator. Example: ["b2b", "saas"]
category_operatorstring- How multiple categories combine: And (company must match all, the default) or Or (any).one of
AndOr citiesarray- Numeric city IDs to filter by, from companyenrich_search_cities. Example: [111182]
countriesarray- Two-letter ISO country codes of the company's headquarters. Example: ["US", "GB"]
employeesarray- Employee count ranges from CompanyEnrich's own data: 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, over-10K. Example: ["51-200", "201-500"]
excludeobject- Companies to leave out. A company matching any of these is excluded. Accepts the same filters as the include side, in the API's camelCase form (domains, countries, regions, states, cities, type, category, employees, reportedEmployees, revenue, naicsCode, keywords, technologies, fundingRounds). Example: {"domains": ["stripe.com"], "countries": ["CN"]}
expandarray- Extra response fields to include. The only value is workforce, which adds a workforce object (observed employee count, employee range and headcount by department) to each company and costs 5 extra credits per company. Omit to skip it. Example: ["workforce"]
founded_yearobject- Range of founding years, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
funding_amountobject- Range of total funding raised in USD, inclusive, as an object with min and/or max. Example: {"min": 1000000, "max": 50000000}
funding_roundsarray- Funding round types the company has raised: seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other. Example: ["series_a", "series_b"]
funding_yearobject- Range of years of the latest funding round, inclusive, as an object with min and/or max. Example: {"min": 2015, "max": 2022}
keywordsarray- Keywords describing what the company does. companyenrich_autocomplete_keywords suggests valid keywords. Example: ["payments", "fintech"]
keywords_operatorstring- How multiple keywords combine: And (all, the default) or Or (any).one of
AndOr listsarray- Only return companies saved in these CompanyEnrich company lists, by list ID (UUID). companyenrich_list_company_lists returns the IDs. Example: ["3fa85f64-5717-4562-b3fc-2c963f66afa6"]
naics_codesarray- NAICS industry codes, 2 to 6 digits. A shorter code includes every 6-digit code under it. companyenrich_list_industries maps industries to codes. Example: [5112, 541511]
pageinteger- Page number to return, starting at 1. page times page_size cannot exceed 10,000. Example: 2
page_sizeinteger- Results per page, 1 to 100. Example: 25
querystring- Text matched against company names and domains, up to 250 characters. Example: stripe
regionsarray- Region IDs to filter by, from companyenrich_list_regions. Example: ["europe"]
reported_employeesarray- Employee count ranges as reported by external data providers, same values as employees. Example: ["1K-5K"]
requirearray- Data the company record must have: linkedin, twitter, facebook, instagram, angellist, crunchbase, youtube, country, city, state, revenue, foundedYear, anyFunding. Example: ["linkedin", "revenue"]
revenuearray- Annual revenue ranges in USD: under-1m, 1m-10m, 10m-50m, 50m-100m, 100m-200m, 200m-1b, over-1b. Example: ["10m-50m"]
semantic_querystring- Natural-language description of the companies to find, up to 500 characters. Ranked by meaning rather than exact words. Example: developer tools for payments infrastructure
semantic_weightnumber- How much the semantic query counts against the other ranking factors, from 0 to 1. Defaults to 0.7; higher values favour semantic similarity. Only used with semantic_query. Example: 0.7
statesarray- Numeric state IDs to filter by, from companyenrich_search_states. Example: [1416]
technologiesarray- Technologies the company uses. companyenrich_autocomplete_technologies suggests valid names. Example: ["Salesforce", "HubSpot"]
technologies_operatorstring- How multiple technologies combine: And (all, the default) or Or (any).one of
AndOr typearray- Company ownership types to include: private, public, self-employed, self-owned, partnership, nonprofit, educational, government. Example: ["private", "public"]
workforce_growthobject- Filter on headcount growth over a period. period is m6 (6 months), y1 or y2; department is overall (the default) or one of c_suite, product_management, engineering_technical, design, education, finance, human_resources, information_technology, legal, marketing, medical_health, operations, sales, consulting; minPercent and maxPercent bound the change in percent (15 means 15% growth, -10 means 10% decline). Example: {"period": "y1", "department": "engineering_technical", "minPercent": 20}
workforce_sizearray- Filter on absolute headcount, one entry per department. Each entry has a department (overall by default, or a department such as engineering_technical or sales) and a min and/or max headcount. Example: [{"department": "engineering_technical", "min": 50}]
companyenrich_search_countriesSearch countries by name.Read-onlySearch Countries
Search countries by name. Free. Returns items (code, name, latitude, longitude), page, totalPages and totalItems; up to 100 per page. Use this to find the two-letter codes for the countries filter of the search tools.
Inputs
pageinteger- Page number, starting at 1. Each page holds up to 100 results. Example: 1
querystring- Country name or part of it, up to 30 characters. Example: germ
companyenrich_search_peopleSearch for professionals by employer, job title, seniority, department, location or education.Read-onlySearch People
Search for professionals by employer, job title, seniority, department, location or education. Costs 2 credits per person returned (minimum 2). Returns items (person profiles with id, name, position, seniority, department, location, social URLs and work experience), page, totalPages and totalItems; pages reach at most 10,000 results. Use this to find decision makers at target accounts. Use companyenrich_scroll_people to go past 10,000 results, companyenrich_lookup_person_by_email when you already have an email address, and companyenrich_find_person_email to get a found person's work email.
Inputs
at_current_company_afterstring- Only include people who joined their current company after this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
at_current_company_beforestring- Only include people who joined their current company before this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
at_current_position_afterstring- Only include people who started their current position after this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
at_current_position_beforestring- Only include people who started their current position before this UTC date-time (ISO 8601). Example: 2025-01-01T00:00:00Z
company_filterobject- Find people at companies that match a company search or a lookalike search instead of listing domains. Set search to an object of company filters in the API's camelCase form (for example countries, employees, keywords, technologies), or similar to {"domains": [...]} to target lookalikes of those companies. Example: {"search": {"countries": ["US"], "employees": ["51-200"], "keywords": ["fintech"]}}
countriesarray- Two-letter ISO country codes of where the person is located. Example: ["US"]
departmentarray- Departments to include. Use a top-level department (c-suite, product-management, engineering-technical, design, education, finance, human-resources, information-technology, legal, marketing, medical-health, operations, sales, consulting) or a sub-department written as parent/child, such as sales/inside-sales or engineering-technical/software-development. Example: ["sales", "marketing/demand-generation"]
domainsarray- Domains of the companies the people currently work at, up to 2,500. Example: ["stripe.com"]
educationobject- Filter on schools attended: institutionNameQuery takes school name search terms and institutionLinkedinHandles takes the schools' LinkedIn handles. Example: {"institutionNameQuery": ["Stanford"]}
excludeobject- People to leave out. A person matching any of these is excluded. Supports positionQuery, countries, domains, seniority, department and education, in the same form as the include filters. Example: {"seniority": ["intern", "entry"], "domains": ["example.com"]}
expandarray- Extra response fields to include. The only value is education, which adds the education history to each person and costs 1 extra credit per person. Omit to skip it. Example: ["education"]
pageinteger- Page number to return, starting at 1. page times page_size cannot exceed 10,000. Example: 2
page_sizeinteger- Results per page, 1 to 100. Example: 25
position_queryarray- Job title search terms matched against each person's current position. A person matches if any term matches. companyenrich_autocomplete_positions suggests titles. Example: ["head of sales", "vp sales"]
querystring- Free-text query, up to 250 characters. CompanyEnrich documents it as matching the company name and domain. Example: stripe
seniorityarray- Seniority levels to include: owner, founder, c-suite, partner, vp, head, director, manager, senior, entry, intern. Example: ["vp", "director"]
companyenrich_search_statesSearch states or provinces by name, optionally within given countries.Read-onlySearch States
Search states or provinces by name, optionally within given countries. Free. Returns items (id, name, code, latitude, longitude), page, totalPages and totalItems; up to 100 per page. Use this to get the numeric IDs for the states filter of companyenrich_search_companies.
Inputs
country_codesarray- Two-letter country codes to search within. Example: ["US"]
pageinteger- Page number, starting at 1. Each page holds up to 100 results. Example: 1
querystring- Name or part of a name, up to 30 characters. Example: calif
No tools match.
