> ## Documentation Index > Fetch the complete documentation index at: https://docs.companyenrich.com/llms.txt > Use this file to discover all available pages before exploring further. # Getting started > What the CompanyEnrich API does, which API fits your job, how to connect, and where to start. CompanyEnrich is a B2B data API. Give it a domain, an email address, a set of filters, or a plain-language description, and it returns company and people records as JSON. You can call the REST API directly, use an official SDK or the CLI, or connect an AI agent through the MCP server. To send your first request, follow the [quickstart](https://docs.companyenrich.com/quickstart.md). ## What you can do | You want to | Use | Credits | | - | - | - | | Turn a domain, company name, or social profile into a company profile | [Company Enrichment API](https://docs.companyenrich.com/docs/company-enrichment-api.md) | 1 per company | | Find companies by country, size, industry, technology, or funding | [Company Search API](https://docs.companyenrich.com/docs/company-search-api.md) | 1 per company | | Find companies from a plain-language description | [Semantic Company Search API](https://docs.companyenrich.com/docs/semantic-company-search-api.md) | 2 per company | | Find companies like your best customers | [Similar Companies API](https://docs.companyenrich.com/docs/similar-companies-api.md) | 5 per company | | Find people by job title, seniority, department, or employer | [People Search API](https://docs.companyenrich.com/docs/people-search-api.md) | 2 per person | | Find the person behind a work email address | [Reverse Email Lookup API](https://docs.companyenrich.com/docs/reverse-email-lookup-api.md) | 5 per person found | | Get a work email address for a person | [Work email lookup](https://docs.companyenrich.com/docs/people-search-api-examples.md#get-a-work-email-for-a-person-you-found) | 10 per new email found | | Get employee counts by department, with history | [Company Headcount API](https://docs.companyenrich.com/docs/company-headcount-api.md) | 1 per 12 months of history | | Enrich thousands of domains or export a large search | [Bulk jobs and exports](https://docs.companyenrich.com/docs/bulk-jobs-and-exports.md) | The same as single requests | | Give an AI agent access to company and people data | [MCP server](https://docs.companyenrich.com/docs/mcp-server.md) | Charged per tool call | You pay for results, not for requests: a lookup that finds nothing is usually free. Counting the matches for a search and checking your account are always free. See [Credits](https://docs.companyenrich.com/docs/credits.md) for every price. ## What you get back Every API returns one of two records. * **Company record.** Name, domain, description, industry, employee range, revenue range, location, and social profiles. Paid expansions add funding, technologies, keywords, NAICS codes, and headcount. See the [company schema](https://docs.companyenrich.com/docs/company-schema.md). * **Person record.** Name, current position, seniority, department, country, LinkedIn URL, and work history. A paid expansion adds education. See the [person schema](https://docs.companyenrich.com/docs/person-schema.md). The [field values](https://docs.companyenrich.com/docs/field-values.md) page lists every value a field can take, such as employee ranges and seniority levels. [Data sources and compliance](https://docs.companyenrich.com/docs/data-sources.md) explains where the data comes from and how it is handled. ## Ways to connect | Option | Best for | Start here | | - | - | - | | REST API | Any language or tool that can send HTTP requests | [API reference](https://docs.companyenrich.com/api-reference/v2/overview.md) | | SDKs | Applications in JavaScript, Python, Ruby, or PHP | [JavaScript](https://docs.companyenrich.com/docs/javascript-typescript-sdk.md), [Python](https://docs.companyenrich.com/docs/python-sdk.md), [Ruby](https://docs.companyenrich.com/docs/ruby-sdk.md), [PHP](https://docs.companyenrich.com/docs/php-sdk.md) | | CLI | Terminal work, scripts, and one-off exports | [CLI](https://docs.companyenrich.com/docs/cli.md) | | MCP server | Claude, Cursor, and other AI clients | [MCP server](https://docs.companyenrich.com/docs/mcp-server.md) | The SDKs and the CLI handle authentication, retries, pagination, and bulk job downloads for you. ## Common workflows **CRM enrichment.** When a new account is created, enrich its domain to fill in industry, size, and location. When a lead arrives with only an email address, a reverse email lookup with the `company` expansion returns the person and their employer's profile in one request. See [Enrich a company by domain](https://docs.companyenrich.com/docs/company-enrichment-api-examples.md#enrich-a-company-by-domain). **Lookalike prospecting.** Send up to 10 of your best customers as seeds and get back a ranked list of similar companies. Add filters to stay in your market, and export the list to CSV. See [Use several seeds and filter by market](https://docs.companyenrich.com/docs/similar-companies-api-examples.md#use-several-seeds-and-filter-by-market). **Market sizing.** Count how many companies match a segment before you buy any of them. Counts are free. See [Size a market for free](https://docs.companyenrich.com/docs/company-search-api-examples.md#size-a-market-for-free). **Finding decision makers.** Search for people at a target company by seniority and department, then look up a work email for the ones you want to reach. See [Find decision makers at a company](https://docs.companyenrich.com/docs/people-search-api-examples.md#find-decision-makers-at-a-company). **Growth signals.** Search for companies whose headcount grew by a set percentage over 6 months, 1 year, or 2 years, overall or in one department such as engineering. See [Find companies that are growing](https://docs.companyenrich.com/docs/company-headcount-api-examples.md#find-companies-that-are-growing). **Job change signals.** Find people who joined a company or started a new position after a date you choose. See [Find recent hires](https://docs.companyenrich.com/docs/people-search-api-examples.md#find-recent-hires). **Form routing.** When a prospect submits an email address, look up the person behind it and route the lead by seniority, department, or company size before it reaches your CRM. See [Find the person behind an email](https://docs.companyenrich.com/docs/reverse-email-lookup-api-examples.md#find-the-person-behind-an-email). **AI agents.** Connect Claude, Cursor, or another MCP client to the hosted MCP server, and the agent can enrich and search without any integration code. See [MCP server](https://docs.companyenrich.com/docs/mcp-server.md). ## API versions The guides, SDKs, and CLI use the V2 API, whose paths start with `/v2`. The V1 API is documented separately under [API V1](https://docs.companyenrich.com/api-reference/v1/overview.md). Prices and request formats can differ between the two, so check the reference for the version you call. The MCP server lists its own [tool prices](https://docs.companyenrich.com/docs/mcp-server.md#tools-and-credits), which differ from V2 in places. ## Next steps > [card] [Quickstart](https://docs.companyenrich.com/quickstart.md) > > Get a key and send your first request. > [card] [Authentication](https://docs.companyenrich.com/authentication.md) > > How to send your API key. > [card] [Credits](https://docs.companyenrich.com/docs/credits.md) > > What each request costs, and what is free. > [card] [API reference](https://docs.companyenrich.com/api-reference/v2/overview.md) > > Every endpoint, with a playground. ## Need help? Contact [support@companyenrich.com](mailto:support@companyenrich.com) with questions or issues. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.