# Companyenrich ```json { "name": "Companyenrich", "slug": "companyenrich", "url": "https://composio.dev/toolkits/companyenrich", "markdown_url": "https://composio.dev/toolkits/companyenrich.md", "logo_url": "https://logos.composio.dev/api/companyenrich", "categories": [ "data & analytics" ], "is_composio_managed": false, "updated_at": "2026-06-18T09:19:53.734Z" } ``` ![Companyenrich logo](https://logos.composio.dev/api/companyenrich) ## Description Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Companyenrich MCP or direct API to enrich company profiles, search businesses, discover similar companies, and build lead intelligence through natural language. ## Summary Companyenrich is a company data API for enrichment, search, and similar company discovery. Use it to turn domains or company names into clean business profiles fast. ## Categories - data & analytics ## Toolkit Details - Tools: 32 ## Images - Logo: https://logos.composio.dev/api/companyenrich ## Authentication - **Api Key** - Type: `api_key` - Description: Api Key authentication for Companyenrich. - Setup: - Configure Api Key credentials for Companyenrich. - Use the credentials when creating an auth config in Composio. ## Suggested Prompts - Enrich OpenAI company profile by domain - Find companies similar to Stripe - Search cybersecurity startups in Berlin ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `COMPANYENRICH_AUTOCOMPLETE_COMPANIES` | Autocomplete Companies | 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. | | `COMPANYENRICH_AUTOCOMPLETE_KEYWORDS` | Autocomplete Keywords | 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", ...] | | `COMPANYENRICH_AUTOCOMPLETE_POSITIONS` | Autocomplete Positions | 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", ...] | | `COMPANYENRICH_AUTOCOMPLETE_TECHNOLOGIES` | Autocomplete Technologies | 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", ...] | | `COMPANYENRICH_COUNT_COMPANIES` | Count companies matching search criteria | 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. | | `COMPANYENRICH_COUNT_SIMILAR_COMPANIES` | Count Similar Companies | 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. | | `COMPANYENRICH_CREATE_PEOPLE_SEARCH_EXPORT_JOB` | Create people search export job | 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). | | `COMPANYENRICH_CREATE_SEARCH_EXPORT_JOB` | Create search export job | 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. | | `COMPANYENRICH_ENRICH_BY_DOMAIN` | Enrich company by domain | 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). | | `COMPANYENRICH_ENRICH_BY_PROPERTIES` | Enrich company by properties | 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). | | `COMPANYENRICH_ENRICH_COMPANIES` | Batch Enrich Companies | 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). | | `COMPANYENRICH_FIND_SIMILAR_COMPANIES` | Find Similar Companies | 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. | | `COMPANYENRICH_GET_BULK_ENRICHMENT_JOB_STATUS` | Get Bulk Enrichment Job Status | 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. | | `COMPANYENRICH_GET_COMPANY_WORKFORCE` | Get Company Workforce | 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. | | `COMPANYENRICH_GET_COUNTRY_BY_CODE` | Get Country by Code | 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. | | `COMPANYENRICH_GET_CURRENT_USER` | Get Current User | 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. Cost: FREE - No credits deducted. | | `COMPANYENRICH_GET_JOB_DETAILS` | Get Job Details | 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. | | `COMPANYENRICH_GET_PEOPLE_SEARCH_EXPORT_JOB_STATUS` | Get People Search Export Job Status | 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. | | `COMPANYENRICH_GET_REGIONS` | Get Regions | 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. | | `COMPANYENRICH_GET_SEARCH_EXPORT_JOB_STATUS` | Get search export job status | 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 | | `COMPANYENRICH_LIST_ALL_JOBS` | List all jobs | 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.) | | `COMPANYENRICH_LIST_BULK_ENRICHMENT_JOBS` | List bulk enrichment jobs | 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) | | `COMPANYENRICH_LIST_INDUSTRIES` | List Industries | 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. | | `COMPANYENRICH_LIST_PEOPLE_SEARCH_EXPORT_JOBS` | List Person Search Export Jobs | 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. | | `COMPANYENRICH_LIST_SEARCH_EXPORT_JOBS` | List search export jobs | 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.) | | `COMPANYENRICH_LOOKUP_PERSON` | Lookup Person by Email | 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. | | `COMPANYENRICH_SCROLL_PEOPLE_SEARCH` | Search people with cursor pagination | 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. | | `COMPANYENRICH_SEARCH_CITIES` | Search cities by name or country | 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. | | `COMPANYENRICH_SEARCH_COMPANIES` | Search companies by criteria | 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. | | `COMPANYENRICH_SEARCH_COUNTRIES` | Search Countries | 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. | | `COMPANYENRICH_SEARCH_PEOPLE` | Search People | 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. | | `COMPANYENRICH_SEARCH_STATES` | Search States | 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. | ## Supported Triggers None listed. ## Installation and MCP Setup ### Path 1: SDK Installation #### Path 1, Step 1: Install Composio Install the Composio SDK ```python pip install composio_openai ``` ```typescript npm install @composio/openai ``` #### Path 1, Step 2: Initialize Composio and Create Tool Router Session Import and initialize Composio client, then create a Tool Router session ```python from openai import OpenAI from composio import Composio from composio_openai import OpenAIResponsesProvider composio = Composio(provider=OpenAIResponsesProvider()) openai = OpenAI() session = composio.create(user_id='your-user-id') ``` ```typescript import OpenAI from 'openai'; import { Composio } from '@composio/core'; import { OpenAIResponsesProvider } from '@composio/openai'; const composio = new Composio({ provider: new OpenAIResponsesProvider(), }); const openai = new OpenAI({}); const session = await composio.create('your-user-id'); ``` #### Path 1, Step 3: Execute Companyenrich Tools via Tool Router with Your Agent Get tools from Tool Router session and execute Companyenrich actions with your Agent ```python tools = session.tools response = openai.responses.create( model='gpt-4.1', tools=tools, input=[{ 'role': 'user', 'content': 'Enrich the company profile for openai.com and include industry, size, and website' }] ) result = composio.provider.handle_tool_calls( response=response, user_id='your-user-id' ) print(result) ``` ```typescript const tools = session.tools; const response = await openai.responses.create({ model: 'gpt-4.1', tools: tools, input: [{ role: 'user', content: 'Enrich the company profile for openai.com and include industry, size, and website' }], }); const result = await composio.provider.handleToolCalls( 'your-user-id', response.output ); console.log(result); ``` ### Path 2: MCP Server Setup #### Path 2, Step 1: Install Composio Install the Composio SDK for Python or TypeScript ```python pip install composio claude-agent-sdk ``` ```typescript npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp ``` #### Path 2, Step 2: Initialize Client and Create Tool Router Session Import and initialize the Composio client, then create a Tool Router session for Companyenrich ```python from composio import Composio from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions composio = Composio(api_key='your-composio-api-key') session = composio.create(user_id='your-user-id') url = session.mcp.url ``` ```typescript import { Composio } from '@composio/core'; const composio = new Composio({ apiKey: 'your-api-key' }); const session = await composio.create('your-user-id'); console.log(`Tool Router session created: ${session.mcp.url}`); ``` #### Path 2, Step 3: Connect to AI Agent Use the MCP server with your AI agent (Anthropic Claude or Mastra) ```python import asyncio options = ClaudeAgentOptions( permission_mode='bypassPermissions', mcp_servers={ 'tool_router': { 'type': 'http', 'url': url, 'headers': { 'x-api-key': 'your-composio-api-key' } } }, system_prompt='You are a helpful assistant with access to Companyenrich tools.', max_turns=10 ) async def main(): async with ClaudeSDKClient(options=options) as client: await client.query('Find companies similar to Stripe and summarize why they match') async for message in client.receive_response(): if hasattr(message, 'content'): for block in message.content: if hasattr(block, 'text'): print(block.text) asyncio.run(main()) ``` ```typescript import { openai } from '@ai-sdk/openai'; import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp'; import { generateText } from 'ai'; const client = await createMCPClient({ transport: { type: 'http', url: session.mcp.url, headers: { 'x-api-key': 'your-composio-api-key', }, }, }); const tools = await client.tools(); const { text } = await generateText({ model: openai('gpt-4o'), tools, messages: [{ role: 'user', content: 'Find companies similar to Stripe and summarize why they match' }], maxSteps: 5, }); console.log(`Agent: ${text}`); ``` ## Why Use Composio? ### 1. AI Native Companyenrich Integration - Supports both Companyenrich MCP and direct API based integrations - Structured, LLM-friendly schemas for reliable company enrichment and search - Rich coverage for company lookup, business discovery, and similar company research ### 2. Managed API Key Auth - Store Companyenrich API keys securely instead of hard-coding them in agent code - Central place to manage, scope, and revoke Companyenrich access - Per user and per environment credentials so your enrichment workflows stay clean and safe ### 3. Agent Optimized Design - Companyenrich tools are designed so agents can understand when to enrich, search, or find similar companies - Tools are tuned using real error and success rates to improve reliability over time - Comprehensive execution logs so you always know what company data was requested, when, and on whose behalf ### 4. Enterprise Grade Security - Fine-grained RBAC so you control which agents and users can access Companyenrich - Scoped, least privilege access to Companyenrich resources - Full audit trail of agent actions to support review, governance, and compliance ## Use Companyenrich with any AI Agent Framework Choose a framework you want to connect Companyenrich with: - [OpenAI Agents SDK](https://composio.dev/toolkits/companyenrich/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/companyenrich/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/companyenrich/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/companyenrich/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/companyenrich/framework/codex) - [OpenClaw](https://composio.dev/toolkits/companyenrich/framework/openclaw) - [Hermes](https://composio.dev/toolkits/companyenrich/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/companyenrich/framework/google-adk) - [LangChain](https://composio.dev/toolkits/companyenrich/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/companyenrich/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/companyenrich/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/companyenrich/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/companyenrich/framework/crew-ai) - [Pydantic AI](https://composio.dev/toolkits/companyenrich/framework/pydantic-ai) - [AutoGen](https://composio.dev/toolkits/companyenrich/framework/autogen) ## Related Toolkits - [Excel](https://composio.dev/toolkits/excel) - Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management. - [21risk](https://composio.dev/toolkits/_21risk) - 21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters. - [Abstract](https://composio.dev/toolkits/abstract) - Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort. - [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time. - [Agentql](https://composio.dev/toolkits/agentql) - Agentql is a toolkit that connects AI agents to the web using a specialized query language. It enables structured web interaction and data extraction for smarter automations. - [Agenty](https://composio.dev/toolkits/agenty) - Agenty is a web scraping and automation platform for extracting data and automating browser tasks—no coding needed. It streamlines data collection, monitoring, and repetitive online actions. - [Ambee](https://composio.dev/toolkits/ambee) - Ambee is an environmental data platform providing real-time, hyperlocal APIs for air quality, weather, and pollen. Get precise environmental insights to power smarter decisions in your apps and workflows. - [Ambient weather](https://composio.dev/toolkits/ambient_weather) - Ambient Weather is a platform for personal weather stations with a robust API for accessing local, real-time, and historical weather data. Get detailed environmental insights directly from your own sensors for smarter apps and automations. - [Anonyflow](https://composio.dev/toolkits/anonyflow) - Anonyflow is a service for encryption-based data anonymization and secure data sharing. It helps organizations meet GDPR, CCPA, and HIPAA data privacy compliance requirements. - [Api ninjas](https://composio.dev/toolkits/api_ninjas) - Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints. - [Api sports](https://composio.dev/toolkits/api_sports) - Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots. - [Apify](https://composio.dev/toolkits/apify) - Apify is a cloud platform for building, deploying, and managing web scraping and automation tools called Actors. It lets you automate data extraction and workflow tasks at scale—no infrastructure headaches. - [Autom](https://composio.dev/toolkits/autom) - Autom is a lightning-fast search engine results data platform for Google, Bing, and Brave. Developers use it to access fresh, low-latency SERP data on demand. - [Beaconchain](https://composio.dev/toolkits/beaconchain) - Beaconchain is a real-time analytics platform for Ethereum 2.0's Beacon Chain. It provides detailed insights into validators, blocks, and overall network performance. - [Big data cloud](https://composio.dev/toolkits/big_data_cloud) - BigDataCloud provides APIs for geolocation, reverse geocoding, and address validation. Instantly access reliable location intelligence to enhance your applications and workflows. - [Bigpicture io](https://composio.dev/toolkits/bigpicture_io) - BigPicture.io offers APIs for accessing detailed company and profile data. Instantly enrich your applications with up-to-date insights on 20M+ businesses. - [Bitquery](https://composio.dev/toolkits/bitquery) - Bitquery is a blockchain data platform offering indexed, real-time, and historical data from 40+ blockchains via GraphQL APIs. Get unified, reliable access to complex on-chain data for analytics, trading, and research. - [Brightdata](https://composio.dev/toolkits/brightdata) - Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction. - [Builtwith](https://composio.dev/toolkits/builtwith) - BuiltWith is a web technology profiler that uncovers the technologies powering any website. Gain actionable insights into analytics, hosting, and content management stacks for smarter research and lead generation. - [Byteforms](https://composio.dev/toolkits/byteforms) - Byteforms is an all-in-one platform for creating forms, managing submissions, and integrating data. It streamlines workflows by centralizing form data collection and automation. ## Frequently Asked Questions ### Do I need my own developer credentials to use Companyenrich with Composio? Yes, Companyenrich requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you. ### Can I use multiple toolkits together? Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview). ### Is Composio secure? Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev). ### What if the API changes? Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)