Beyond-Bot.ai Logo+Companyenrich Logo

Beyond-Bot.ai + Companyenrich

CompanyEnrich provides instant company data enrichment, search, and similar company discovery through API endpoints.

What You Can Do with this Integration

Automate Data Entry

Automatically sync new contacts or deals from Beyond-Bot.ai to Companyenrich.

Enrich Customer Profiles

Use Beyond-Bot.ai to find and add new information to your records in Companyenrich.

Trigger Workflows

Start automated workflows in Companyenrich based on conversations with your virtual expert.

Available Actions

Here are the specific actions your virtual expert can perform within Companyenrich.

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.

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", ...]

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", ...]

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", ...]

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.

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.

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).

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.

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).

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).

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).

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.

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.

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.

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.

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.

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.

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.

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.

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

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.)

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)

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.

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.

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.)

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.

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.

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.

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.

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.

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.

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.