Companyenrich

Returns a list of companies matching the given partial domain name. This is useful for autocompleting domain names in your application. Up to 10 companies are returned per request. Cost: FREE - No credits deducted. Use when you need to autocomplete company domains in your application.

Lookup keywords for use in company search filters. This endpoint returns a list of keywords that match the provided query string. Use this action to discover valid keyword values before using them in company search filters. The results are sorted by relevance. Example: query="tech" might return ["Technology", "Tech", "Information Technology", ...]

Lookup positions/job titles for use in people search filters. This endpoint returns a list of job titles that match the provided query string. Use this action to discover valid position values before using them in people search filters. The results are sorted by relevance. Example: query="engineer" might return ["Software Engineer", "Data Engineer", "Sales Engineer", ...]

Lookup technologies for use in company search filters. This endpoint returns a list of technology names that match the provided query string. Use this action to discover valid technology values before using them in company search filters. The results are sorted by relevance. Example: query="react" might return ["React", "React Native", "ReactJS", ...]

Returns the total count of companies matching the given search criteria without retrieving the actual results. Use this action to check how many companies match your filters before performing a full search. Cost: FREE - No credits deducted.

Tool to count the total number of similar companies matching the given search criteria without retrieving the actual results. Use when you need to know how many similar companies exist before making a request to fetch them, or when you only need the count without the full company details. Cost: FREE - No credits deducted.

Create an asynchronous enrichment job for up to 10,000 domains. Cost: 1 credit per domain successfully enriched (charged on completion). The `workforce` expansion costs 5 credits per company.

Start an asynchronous job containing 1 to 1,000 person email lookups. Each item costs up to 10 credits, charged on completion only when a newly accessed email is found. Beta: provider coverage, orchestration, and response behavior may change.

Create a durable company list from search or similar-company results. This action is result-charged: search costs 1 credit per company with a 1-credit minimum; similar costs 5 credits per company with a 5-credit minimum. If no companies are found, CompanyEnrich does not create the list. Although count accepts up to 10,000, the provider selects only the first 5,000 results for the list.

Creates an asynchronous search export job for up to 50,000 people. Use when you need to export large sets of people data that will be processed in the background. The job returns immediately with a job ID, and the webhook URL will be called with a notification when processing completes. Cost: 2 credits per person returned (charged on completion).

Creates an asynchronous search export job for company data. Supports both standard company search and similar-company search. Returns a job ID immediately while processing happens in the background. The webhook URL (if provided) will be called with a notification when processing completes. Cost: 1 credit per company returned (charged on completion). Use this action when you need to export large datasets (up to 50,000 companies) that would take too long for a synchronous request. The job runs asynchronously and notifies you via webhook when complete.

Permanently delete a company list and all of its entries.

Enriches a company using its domain name as lookup parameter. This is the preferred way to enrich a company as domain lookups are fast and reliable. Each domain maps to a unique company. Cost: 1 credit per call (5 credits if workforce expansion is requested).

Enriches a company using its properties. You must provide at least one of the following properties: name, linkedinUrl, linkedinId, twitterUrl, facebookUrl, instagramUrl. Best match is used to determine the company in case of ambiguity. Cost: 1 credit per call (5 credits if workforce expansion is requested).

Enriches a list of companies using their domain names. Use when you need to enrich multiple companies in a single request. Up to 50 domains can be provided. Each domain maps to a unique company. Cost: 1 credit per domain enriched (5 credits for workforce expansion).

Tool to find similar companies to the given company by domain. Use when you need to find companies similar to a target company based on industry, size, or other characteristics. Returns up to 100 companies per request. Cost: 5 credits per company returned, 5 credits if no results found.

Returns the current status of a bulk enrichment job. Once the job is completed, the response includes a results_url to download the enrichment results. Cost: FREE - No credits deducted. Use when you need to check the progress of a bulk enrichment job or get the results URL after the job completes.

Check a bulk person email job for free. Returns its status, credits_charged, and results_url when available; status checks do not deduct credits. Beta: provider coverage, orchestration, and response behavior may change.

Retrieve a company by its CompanyEnrich UUID for 1 credit per call. Requesting the `workforce` expansion costs 5 additional credits per company.

Retrieve one saved company list by its UUID.

Returns workforce insights for a single company. You must provide exactly one lookup parameter: id or domain. The response includes observed employee count, an employee range bucket, and headcounts grouped by root departments. Costs 5 credits per successful call. Use when you need to find workforce details (employee count, department breakdown) for a specific company given its domain or company ID.

Tool to search for a country by its ISO 3166-1 alpha-2 code. Returns country information including name, coordinates, and country code. Use when you need to retrieve details about a specific country. Example: Get country details for US, GB, DE, etc.

Returns information about the authenticated user, including their credit balance and account capabilities. This endpoint requires authentication via an API key in the Authorization header. Cost: FREE - No credits deducted.

Returns details for a specific job by ID. Use when you need to check the status, progress, or result of an async enrichment job. Cost: FREE - No credits deducted.

Returns the current status of a person search export job. Once completed, includes the results_url to download the export results. Use when: - Checking if an async person search export job has completed - Getting the download URL for completed exports - Monitoring job progress or checking for errors Cost: FREE - No credits deducted for status checks.

Retrieve a person by CompanyEnrich ID for 2 credits. Optionally request the education expansion for 1 additional credit.

Retrieve a person's education history for 1 credit per successful call.

Tool to get all available regions. Returns a list of all geographic regions supported by the API. Use when you need to retrieve region information for filtering or validation purposes.

Returns the current status of a search export job. Once the job is completed, the response will include a results_url that can be used to download the exported company data. This action is free - no credits are deducted. Use this action to: - Check if an export job has completed - Get the download URL for completed exports - Monitor job progress and troubleshoot failures

Returns a paginated list of all jobs (bulk enrichment, etc.) for the authenticated user. Supports optional filtering by job status and type. Cost: FREE - No credits deducted. Use this action to: - View all your jobs - Check the status of jobs - Monitor job progress and completion - Filter jobs by status (pending, processing, completed, failed, etc.) - Filter jobs by type (bulk_enrichment, etc.)

Returns a paginated list of all bulk enrichment jobs for the authenticated user. Supports optional filtering by job status. This action is free - no credits are deducted. Use this action to: - View all your bulk enrichment jobs - Check the status of enrichment jobs - Monitor enrichment job progress and completion - Filter jobs by status (pending, processing, completing, completed, failed)

Return all saved company lists for the authenticated user.

Obtain a list of all company industries. Returns all industry names along with their associated NAICS code prefixes. Use when you need to retrieve the complete list of industries for filtering or categorization.

Returns a paginated list of all person search export jobs for the authenticated user. Supports optional filtering by job status. Use this to check the status of previously submitted export jobs, view progress, or retrieve export results. Cost: FREE - No credits deducted.

Returns a paginated list of all search export jobs for the authenticated user. Supports optional filtering by job status. This action is free - no credits are deducted. Use this action to: - View all your search export jobs - Check the status of export jobs - Monitor export job progress and completion - Filter jobs by status (pending, processing, completed, failed, etc.)

Look up a person by email address. We resolve the company from the email domain first, then match the person by email local-part patterns. Returns the best deterministic match when found. Costs 5 credits per successful call. Use when you need to find person details (name, position, company, etc.) given an email address.

Resolve a work email for a person, optionally on a specific domain. Costs 10 credits only when a newly accessed email is found. Beta: provider coverage and response behavior may change.

Preview the top 25 companies matching a search. Cost: FREE - No credits deducted. Requirements: Requires Scale plans. Notice: Returns the top 25 results only.

Preview the top 25 similar companies for free without deducting credits. Requires a Scale plan. By default, a missing seed company is enriched on demand. With `wait_for_enrichment=False`, missing domains are scheduled for background enrichment and the request returns 404 without charging credits.

Search and continue company results with an opaque cursor. Cost: 1 credit per company returned, with a 1-credit minimum when no results are found. The optional workforce expansion costs 5 credits per company. Returns at most 100 companies per request and supports results beyond 10,000.

Searches people based on given criteria using cursor-based pagination. Use when you need to find people at specific companies or with particular roles. You can request the next page of results by using the cursor parameter. Cost: 2 credits per person returned, 2 credits minimum if no results are found.

Scroll similar-company results using an opaque cursor. Costs 5 credits per company returned, with a 5-credit minimum when no results are found. By default, a missing seed company is enriched on demand. With `wait_for_enrichment=False`, missing domains are scheduled for background enrichment and the request returns 404 without charging credits.

Search for cities by name or country codes. Returns up to 100 cities per page. Use when you need to find cities matching a query string, optionally filtered by country codes.

Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. Up to 10,000 results can be returned from this endpoint (page * pageSize cannot exceed 10,000). For more results, use the scroll endpoint. Cost: 1 credit per company returned, 1 credit minimum if no results are found.

Tool to search countries by name. Returns up to 100 countries per page. Use when you need to find country information including codes, names, and coordinates. Supports pagination and filtering by name query.

Searches people based on given criteria using page-based pagination. Up to 10,000 results can be returned from this endpoint (page * pageSize cannot exceed 10,000). For more results, use the scroll endpoint. Cost: 2 credits per person returned, 2 credits minimum if no results are found.

Tool to search states by name or country codes. Returns up to 100 states per page. Use when you need to find states within a country or search states by name.

Rename a saved company list. This is a durable mutation of the list.