# CompanyEnrich Documentation > CompanyEnrich is AI-powered API platform for company data enrichment, search, and lookalike discovery. Instantly access detailed, accurate company intelligence for sales, marketing, and business development. ## Guides - [Getting Started](https://docs.companyenrich.com/docs/getting-started.md): CompanyEnrich is a real-time B2B data API for enriching companies, finding people, discovering lookalike accounts, resolving emails, and powering AI agents with fresh company intelligence. - [Data Sources](https://docs.companyenrich.com/docs/data-sources.md) - [MCP Server](https://docs.companyenrich.com/docs/mcp-server.md) - [Rate Limit](https://docs.companyenrich.com/docs/rate-limit.md) - [Credits](https://docs.companyenrich.com/docs/credits.md) ## API Reference - [Enrich by domain](https://docs.companyenrich.com/reference/get_companies-enrich.md): **Cost:** 1 credit per call Enriches a company using its domain name as lookup parameter. We map each domain to a unique company so lookups via domain are fast and reliable. It is the preferred way to enrich a company. In case the domain name could not be enriched, the API will return a 404 error. - [Enrich by properties](https://docs.companyenrich.com/reference/post_companies-enrich.md): **Cost:** 1 credit per call Enriches a company using its properties. You need to 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. - [Batch enrich](https://docs.companyenrich.com/reference/post_companies-enrich-batch.md): **Cost:** 1 credit per domain enriched Enriches a list of companies using their domain names. Up to 50 domains can be provided in a single request. We map each domain to a unique company so lookups via domain are fast and reliable. It is the preferred way to enrich a company. Batching is recommended for larger lists of domains. It allows you to enrich multiple companies in a single request. Eliminating the need to make multiple requests to the API. Also the rate limiter would be able to handle more requests. - [Workforce](https://docs.companyenrich.com/reference/get_companies-workforce.md): **Cost:** 5 credits per successful call 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. - [Autocomplete](https://docs.companyenrich.com/reference/get_companies-autocomplete.md): **Cost:** FREE - No credits deducted 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. - [Create job](https://docs.companyenrich.com/reference/post_companies-enrich-bulk.md): **Cost:** 1 credit per domain successfully enriched (charged on completion) Creates an asynchronous bulk enrichment job for up to 10,000 domains. Returns a job ID immediately. The webhook URL will be called with a notification when processing completes. Use the status endpoint to track progress and retrieve results. - [Get job status](https://docs.companyenrich.com/reference/get_companies-enrich-bulk-jobid.md): **Cost:** FREE - No credits deducted Returns the current status of a bulk enrichment job. Once completed, includes the results_url to download the enrichment results. - [List jobs](https://docs.companyenrich.com/reference/get_companies-enrich-bulk-jobs.md): **Cost:** FREE - No credits deducted Returns a paginated list of all bulk enrichment jobs for the authenticated user. Supports optional filtering by job status. - [Search](https://docs.companyenrich.com/reference/post_companies-search.md): **Cost:** 1 credit per company returned. 1 credit minimum if no results are found. **Notice**: Up to 10.000 results can be returned from this endpoint (page * pageSize can not exceed 10.000). If you need more results, please use the scroll endpoint. Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. At most 100 companies are returned per request. If you need more results, please use the pagination parameters. - [Preview](https://docs.companyenrich.com/reference/post_companies-search-preview.md): **Cost:** FREE - No credits deducted **Requirements:** Requires **Scale** plans **Notice:** Returns top 25 results only Preview search for companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. This endpoint returns the top 25 results for free, perfect for previewing search results before running a full search. - [Count](https://docs.companyenrich.com/reference/post_companies-search-count.md): **Cost:** FREE - No credits deducted Returns the total count of companies matching the given search criteria without retrieving the actual results. - [Scroll](https://docs.companyenrich.com/reference/post_companies-search-scroll.md): **Cost:** 1 credit per company returned. 1 credit minimum if no results are found. Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. At most 100 companies are returned per request. You can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set. In case on no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results. This will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results. - [Get by ID](https://docs.companyenrich.com/reference/get_companies.md): **Cost:** 1 credits per call Gets a company information by its CompanyEnrich ID. You can obtain this ID by calling the Enrich endpoint or other endpoints returning company information. - [Create export job](https://docs.companyenrich.com/reference/post_companies-search-async.md): **Cost:** 1 credit per company returned (reserved when the job is created, settled on completion) Creates an asynchronous search export job for up to 50,000 companies. Supports both standard company search and similar-company search. Returns a job ID immediately. The webhook URL will be called with a notification when processing completes. Use the status endpoint to track progress and retrieve results. - [Get export job status](https://docs.companyenrich.com/reference/get_companies-search-async-jobid.md): **Cost:** FREE - No credits deducted Returns the current status of a search export job. Once completed, includes the results_url to download the export results. - [List export jobs](https://docs.companyenrich.com/reference/get_companies-search-async-jobs.md): **Cost:** FREE - No credits deducted Returns a paginated list of all search export jobs for the authenticated user. Supports optional filtering by job status. - [Find similar](https://docs.companyenrich.com/reference/post_companies-similar.md): **Cost:** 5 credit per company returned. 5 credits if no results are found. Finds similar companies to the given company by id or domain. The POST route allows specifying further filtering parameters. At most 100 companies are returned per request. - [Preview](https://docs.companyenrich.com/reference/post_companies-similar-preview.md): **Cost:** FREE - No credits deducted **Requirements:** Requires **Scale** plans **Notice:** Returns top 25 results only Preview search for similar companies based on given criteria. You can search by domain, industry, employees, revenue, founded year, and more. This endpoint returns the top 25 similar companies for free, perfect for previewing results before running a full similar search. - [Count](https://docs.companyenrich.com/reference/post_companies-similar-count.md): **Cost:** FREE - No credits deducted Returns the total count of similar companies matching the given search criteria without retrieving the actual results. - [Scroll](https://docs.companyenrich.com/reference/post_companies-similar-scroll.md): **Cost:** 5 credit per company returned. 5 credits if no results are found. Finds similar companies to the given company by id or domain. The POST route allows specifying further filtering parameters. At most 100 companies are returned per request. You can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set. In case on no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results. This will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results. - [Lookup person](https://docs.companyenrich.com/reference/post_people-lookup.md): **Cost:** 5 credits per successful call Looks 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. - [Get by ID](https://docs.companyenrich.com/reference/get_people.md): **Cost:** 2 credits per call Gets person information by its CompanyEnrich ID. You can obtain this ID from people search results, lookup responses, and other endpoints returning person information. - [Search](https://docs.companyenrich.com/reference/post_people-search.md): **Cost:** 2 credits per person returned. 2 credits minimum if no results are found. **Notice**: Up to 10.000 results can be returned from this endpoint (page * pageSize can not exceed 10.000). If you need more results, please use the scroll endpoint. Searches people based on given criteria using page-based pagination. - [Scroll](https://docs.companyenrich.com/reference/post_people-search-scroll.md): **Cost:** 2 credits per person returned. 2 credits minimum if no results are found. Searches people based on given criteria using cursor-based pagination. You can request the next page of results by using the `cursor` parameter. The cursor is a string that encodes the current position in the result set. In case no cursor is provided, the first page of results is returned. You can then use the `next_cursor` parameter to get the next page of results. This will allow you to scroll over the results without having to keep track of the current page number and also allow paginating into more than 10.000 results. - [Email (BETA)](https://docs.companyenrich.com/reference/get_people-email.md): **BETA:** This endpoint is currently in beta and may change based on provider coverage and response tuning. **Cost:** 10 credits per newly accessed found email Resolves a work email address for a single person on a specific domain. If `domain` is omitted, current experience domains are tried automatically in seniority order. If `domain` is provided, it must match one of the person's experiences. The response does not expose provider details. It returns a person summary, the selected domain, and a status of `pending`, `found`, `not-found`, or `unavailable`. When the lookup completes successfully, the response also includes the resolved email and certainty value. - [Create bulk email enrichment job (BETA)](https://docs.companyenrich.com/reference/post_people-email-bulk.md): **BETA:** This endpoint is currently in beta and may change based on provider coverage, job orchestration, and response tuning. **Cost:** up to 10 credits per item (charged on completion for newly accessed found emails only) Creates an asynchronous bulk person email enrichment job for up to 1,000 lookup items. When `domain` is omitted for an item, current experience domains are tried in seniority order. Processing happens asynchronously in the background. Use the status endpoint to monitor progress and retrieve the results download URL. - [Get bulk email enrichment job status (BETA)](https://docs.companyenrich.com/reference/get_people-email-bulk-jobid.md): **BETA:** This endpoint is currently in beta and may change based on provider coverage, job orchestration, and response tuning. **Cost:** FREE - No credits deducted Returns the current status of a bulk person email enrichment job. Once completed, includes the results_url to download the full results. - [Create export job](https://docs.companyenrich.com/reference/post_people-search-async.md): **Cost:** 2 credits per person returned (reserved when the job is created, settled on completion) Creates an asynchronous search export job for up to 50,000 people. Returns a job ID immediately. The webhook URL will be called with a notification when processing completes. Use the status endpoint to track progress and retrieve results. - [Get export job status](https://docs.companyenrich.com/reference/get_people-search-async-jobid.md): **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. - [List export jobs](https://docs.companyenrich.com/reference/get_people-search-async-jobs.md): **Cost:** FREE - No credits deducted Returns a paginated list of all person search export jobs for the authenticated user. Supports optional filtering by job status. - [List all jobs](https://docs.companyenrich.com/reference/get_jobs.md): **Cost:** FREE - No credits deducted Returns a paginated list of all jobs (bulk enrichment, etc.) for the authenticated user. Supports optional filtering by job status and type. - [Get job details](https://docs.companyenrich.com/reference/get_jobs-jobid.md): **Cost:** FREE - No credits deducted Returns details for a specific job by ID. - [Get all lists](https://docs.companyenrich.com/reference/get_lists-companies.md): Get all company lists for the current user - [Create list](https://docs.companyenrich.com/reference/post_lists-companies.md): **Cost:** - For search: 1 credit per company returned. 1 credit if no results are found. - For similar: 5 credits per company returned. 5 credits if no results are found. Creates a new list based on a search or similar company request. Up to first 5000 results can be selected to be added to the list. If no companies are found, the list is not created. - [Get a list by id](https://docs.companyenrich.com/reference/get_lists-companies-id.md): Get a company list by id - [Update list](https://docs.companyenrich.com/reference/put_lists-companies-id.md): Updates a list's properties - [Delete list](https://docs.companyenrich.com/reference/delete_lists-companies-id.md): Deletes a list and all its entries - [Get regions](https://docs.companyenrich.com/reference/get_geo-regions.md): Returns all regions. - [Get country by code](https://docs.companyenrich.com/reference/get_geo-countries-countrycode.md): Searches a country by its ISO 3166-1 alpha-2 code. - [Search countries](https://docs.companyenrich.com/reference/post_geo-countries.md): Searches countries by name. Returns up to 100 countries per page. - [Search states](https://docs.companyenrich.com/reference/post_geo-states.md): Searches states by name or country codes. Returns up to 100 states per page. - [Search cities](https://docs.companyenrich.com/reference/post_geo-cities.md): Searches cities by name or country codes. Returns up to 100 cities per page. - [List industries](https://docs.companyenrich.com/reference/get_industries.md): Obtain a list of all company industries - [Lookup keywords](https://docs.companyenrich.com/reference/get_keywords-autocomplete.md) - [Lookup technologies](https://docs.companyenrich.com/reference/get_technologies-autocomplete.md) - [Get current user information](https://docs.companyenrich.com/reference/get_me.md): **Cost:** FREE - No credits deducted Returns information about the authenticated user, including their API key, credit balance, and account capabilities. This endpoint requires authentication via an API key in the Authorization header. - [Lookup positions](https://docs.companyenrich.com/reference/get_positions-autocomplete.md) ## Changelog - [Company Headcount API](https://docs.companyenrich.com/changelog/company-headcount-api.md) - [Reverse Email Lookup API](https://docs.companyenrich.com/changelog/reverse-email-lookup-api.md) - [People Search API](https://docs.companyenrich.com/changelog/people-search-api.md) - [Autocomplete Companies Endpoint](https://docs.companyenrich.com/changelog/autocomplete-companies-api.md) - [Preview Endpoints](https://docs.companyenrich.com/changelog/preview-endpoints.md) - [Company Funding Data](https://docs.companyenrich.com/changelog/company-funding-data.md) - [Technology Stack Search](https://docs.companyenrich.com/changelog/technology-stack-search.md) - [Keyword Search](https://docs.companyenrich.com/changelog/keyword-search.md) - [Semantic Search](https://docs.companyenrich.com/changelog/semantic-search.md) - [Exclude Filters](https://docs.companyenrich.com/changelog/exclude-filters.md)