The Companies API connector for AI agents

Tools your company data agent reaches for on The Companies API, scoped per user.

CALL ANY TOOL

34 tools for company data in The Companies API: search and count companies, enrich them by domain, email, or social profile, find lookalikes and email patterns, ask questions about a company, and manage lists and bulk jobs.

thecompaniesapi_ask_company

Ask company

Ask an AI question about a company, identified by its domain, and get a structured answer. Returns the answer (output values, explanation and confidence score) inside the prompt object, plus the model used and the credit cost. Use this for a specific fact that is not in the standard profile, such as which products a company sells. Use thecompaniesapi_get_company_context for a general overview.

Parameters

Name

Type

Required

Description

domain

string

Required

Company website domain, without protocol or path. Example: stripe.com

question

string

Required

The question to answer about the company. Example: What products does this company sell?

explain

boolean

Optional

Set to true to include an explanation of how the answer was reached. Defaults to false.

fields

array

Optional

Structured fields the answer must fill. Each field needs a key and a type (string, number, boolean, or array|string, array|number, array|boolean), and can add a description and a fixed set of allowed values. Omit to get a free-form answer. Example: [{"key": "products", "type": "array|string", "description": "The products the company sells"}]

model

string

Optional

AI model size: small (cheaper, faster) or large (more capable). Example: large. One of: `small`, `large`.

thecompaniesapi_count_companies

Count companies

thecompaniesapi_create_list

List create

thecompaniesapi_delete_list

List delete

thecompaniesapi_enrich_job_title

Enrich job title

thecompaniesapi_generate_search_query

Query generate search

thecompaniesapi_get_companies_analytics

Get companies analytics

thecompaniesapi_get_company

Get company

thecompaniesapi_get_company_by_email

Get company by email

thecompaniesapi_get_company_by_social

Get company by social

Enrich the company behind a social profile URL, such as its LinkedIn company page. Returns the company profile: name, domain, industries, employee range, location, social profiles and technologies. Use this when you have a LinkedIn, X, Facebook or other social URL but not the domain. Use thecompaniesapi_get_company when you have the domain.

Parameters

Name

Type

Required

Description

angellist

string

Optional

Full URL of the company's AngelList profile. Provide at least one social URL. Example: https://angel.co/company/stripe

dribbble

string

Optional

Full URL of the company's Dribbble profile. Provide at least one social URL. Example: https://dribbble.com/stripe

facebook

string

Optional

Full URL of the company's Facebook profile. Provide at least one social URL. Example: https://www.facebook.com/StripeHQ

github

string

Optional

Full URL of the company's GitHub profile. Provide at least one social URL. Example: https://github.com/stripe

instagram

string

Optional

Full URL of the company's Instagram profile. Provide at least one social URL. Example: https://www.instagram.com/stripehq

string

Optional

Full URL of the company's LinkedIn profile. Provide at least one social URL. Example: https://www.linkedin.com/company/stripe

string

Optional

Full URL of the company's Pinterest profile. Provide at least one social URL. Example: https://www.pinterest.com/stripe

refresh

boolean

Optional

Set to true to re-analyze the company in real time instead of returning the stored profile. Slower, but returns the freshest data. Defaults to false.

simplified

boolean

Optional

Set to true to return a reduced company profile that costs no credits (the free plan limits how many). Defaults to false, which returns the full profile.

snapchat

string

Optional

Full URL of the company's Snapchat profile. Provide at least one social URL. Example: https://www.snapchat.com/add/stripe

soundcloud

string

Optional

Full URL of the company's SoundCloud profile. Provide at least one social URL. Example: https://soundcloud.com/stripe

tiktok

string

Optional

Full URL of the company's TikTok profile. Provide at least one social URL. Example: https://www.tiktok.com/@stripe

twitter

string

Optional

Full URL of the company's X (Twitter) profile. Provide at least one social URL. Example: https://twitter.com/stripe

wellfound

string

Optional

Full URL of the company's Wellfound profile. Provide at least one social URL. Example: https://wellfound.com/company/stripe

youtube

string

Optional

Full URL of the company's YouTube profile. Provide at least one social URL. Example: https://www.youtube.com/@stripe

thecompaniesapi_get_company_context

Get company context

thecompaniesapi_get_company_email_patterns

Get company email patterns

thecompaniesapi_get_company_in_list

List get company in

thecompaniesapi_get_current_user

Get current user

thecompaniesapi_list_actions

List actions

thecompaniesapi_list_companies_in_list

List list companies in

List the companies in one of your lists, optionally narrowed by filter conditions. Returns a page of company profiles with pagination info. Use this to read a saved list. Use thecompaniesapi_get_company_in_list to check one company, and thecompaniesapi_search_companies to search the whole database.

Parameters

Name

Type

Required

Description

list_id

integer

Required

ID of the list. thecompaniesapi_list_lists returns list IDs. Example: 4210

page

integer

Optional

Page of results to return, starting at 1. Defaults to 1. Example: 2

query

array

Optional

Filter conditions; a company must match every condition. Each condition names an attribute (for example about.industries, about.totalEmployees, locations.headquarters.country.code, technologies.active, finances.revenue or ai.search), a sign (equals, exactEquals, notEquals, greater or lower), the values to compare against, and an operator (or / and) that decides whether a company must match any or all of those values. Industry, technology and location values are the slugs and codes returned by the industry, technology and location search tools; thecompaniesapi_generate_search_query turns a plain-English description into these conditions. Example: [{"attribute": "about.industries", "operator": "or", "sign": "equals", "values": ["computer-software"]}, {"attribute": "locations.headquarters.country.code", "operator": "or", "sign": "equals", "values": ["us", "gb"]}]

simplified

boolean

Optional

Set to true to return a reduced company profile that costs no credits (the free plan limits how many). Defaults to false, which returns the full profile.

size

integer

Optional

Number of results per page, from 1 to 100. Defaults to 10. Example: 25

sort_by

string

Optional

Company field to sort results by, such as meta.score (relevance score), about.totalEmployees, about.yearFounded, analytics.monthlyVisitors or finances.revenue. Use with sort_order. Example: about.totalEmployees. One of: `about.businessType`, `about.industries`, `about.industry`, `about.name`, `about.totalEmployees`, `about.yearFounded`, `analytics.monthlyVisitors`, `apps`, `codes.naics`, `codes.sic`, `contacts`, `domain.domain`, `domain.tld`, `finances.revenue`, `locations.headquarters.city.code`, `locations.headquarters.country.code`, `locations.headquarters.county.code`, `locations.headquarters.state.code`, `meta.score`, `meta.syncedAt`, `socials`, `technologies.active`, `urls`.

sort_order

string

Optional

Sort direction for sort_by: asc or desc. Example: desc. One of: `asc`, `desc`.

thecompaniesapi_list_lists

List lists

thecompaniesapi_request_action

Request action

thecompaniesapi_retry_action

Retry action

thecompaniesapi_search_cities

Search cities

thecompaniesapi_search_companies

Search companies

Search the company database with filter conditions on industry, size, location, technologies, revenue and more, optionally combined with a name or domain text search. Returns a page of matching company profiles, pagination info (total, current and last page) and the credit cost. Each returned company costs 1 credit unless simplified is true. Use this for structured filters. Use thecompaniesapi_search_companies_by_prompt for a plain-English description, thecompaniesapi_search_companies_by_name for a name lookup, and thecompaniesapi_count_companies to size a segment without paying for results.

Parameters

Name

Type

Required

Description

domains_to_exclude

string

Optional

Comma-separated domains to leave out of the results. Example: amazon.com,pearson.com

linkedin_to_exclude

string

Optional

Comma-separated LinkedIn company URLs to leave out of the results. Example: https://www.linkedin.com/company/amazon

page

integer

Optional

Page of results to return, starting at 1. Defaults to 1. Example: 2

query

array

Optional

string

Optional

Optional text matched against company names or domains (see search_fields). Example: pay

search_fields

array

Optional

Which fields the search text matches against: about.name (company name), domain.domain (website domain), or both. Example: ["about.name"]

simplified

boolean

Optional

Set to true to return a reduced company profile that costs no credits (the free plan limits how many). Defaults to false, which returns the full profile.

size

integer

Optional

Number of results per page, from 1 to 100. Defaults to 10. Example: 25

sort_by

string

Optional

sort_order

string

Optional

Sort direction for sort_by: asc or desc. Example: desc. One of: `asc`, `desc`.

thecompaniesapi_search_companies_by_name

Search companies by name

Find companies by name, optionally limited to some countries. Returns matching company profiles with pagination info. Several companies can share a name, so check the domain and location of each result. Each returned company costs 1 credit unless simplified is true. Use this to resolve a company name to its domain and profile. Use thecompaniesapi_get_company when you already have the domain, and thecompaniesapi_search_companies for filter-based search.

Parameters

Name

Type

Required

Description

name

string

Required

Company name to search for. Example: Stripe

countries

string

Optional

Comma-separated two-letter country codes, in lowercase, to limit results to. Example: us,gb,fr

exact_words_match

boolean

Optional

When true (the API default), every searched word must appear in the name: 'Bank of' matches Bank of America but 'Bank of A' does not. Set to false for looser matching.

lists_to_exclude

string

Optional

Comma-separated IDs of your lists whose companies should be left out of the results. Example: 3920,3925

page

integer

Optional

Page of results to return, starting at 1. Defaults to 1. Example: 2

simplified

boolean

Optional

Set to true to return a reduced company profile that costs no credits (the free plan limits how many). Defaults to false, which returns the full profile.

size

integer

Optional

Number of results per page, from 1 to 25. Defaults to 1. Example: 25

sort_by

string

Optional

sort_order

string

Optional

Sort direction for sort_by: asc or desc. Example: desc. One of: `asc`, `desc`.

thecompaniesapi_search_companies_by_prompt

Search companies by prompt

Search companies with a plain-English description, such as 'SaaS companies in the United States with more than 100 employees'. Returns matching company profiles with pagination info. Each returned company costs 1 credit unless simplified is true. Use this when the user describes the companies in words. Use thecompaniesapi_search_companies for exact filter conditions, and thecompaniesapi_generate_search_query to see or reuse the conditions a description maps to.

Parameters

Name

Type

Required

Description

prompt

string

Required

Plain-English description of the companies to find. Example: SaaS companies in the United States with more than 100 employees

lists_to_exclude

string

Optional

Comma-separated IDs of your lists whose companies should be left out of the results. Example: 3920,3925

page

integer

Optional

Page of results to return, starting at 1. Defaults to 1. Example: 2

similarity

number

Optional

Similarity threshold from 0 to 2 (API default 1.875). Higher values keep only closer matches. Example: 1.875

simplified

boolean

Optional

Set to true to return a reduced company profile that costs no credits (the free plan limits how many). Defaults to false, which returns the full profile.

size

integer

Optional

Number of results per page, from 1 to 50. Defaults to 10. Example: 25

sort_by

string

Optional

sort_order

string

Optional

Sort direction for sort_by: asc or desc. Example: desc. One of: `asc`, `desc`.

thecompaniesapi_search_continents

Search continents

thecompaniesapi_search_countries

Search countries

thecompaniesapi_search_industries

Search industries

thecompaniesapi_search_similar_companies

Search similar companies

thecompaniesapi_search_similar_industries

Search similar industries

thecompaniesapi_search_states

Search states

thecompaniesapi_toggle_companies_in_list

List toggle companies in

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// The Companies API tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["thecompaniesapi"], toolNames: [
    "thecompaniesapi_search_companies_by_prompt",
    "thecompaniesapi_get_company",
    "thecompaniesapi_create_list"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Find US SaaS companies with 50 to 200 employees and save them to a list" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["thecompaniesapi"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Find US SaaS companies with 50 to 200 employees and save them to a list" }],
  tools,
});

// Execute the tool call with the user's vaulted The Companies API key
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["thecompaniesapi"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Find US SaaS companies with 50 to 200 employees and save them to a list" }],
  tools,
});

// Tool call runs with the user's vaulted The Companies API key
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["thecompaniesapi"] }, pageSize: 100,
});

const agent = new Agent({
  name: "company_research_agent",
  model: "gemini-2.5-pro",
  instruction: "The Companies API tools scoped to this user",
  tools,
});

await agent.run("Find US SaaS companies with 50 to 200 employees and save them to a list");

Try these prompts

Copy any prompt into your agent. Each maps directly to a The Companies API tool. Click to copy, paste into your agent, done.

Copy the prompt

Copied

Find SaaS companies in the United States with 50 to 200 employees.

Copy the prompt

Copied

How many companies in Germany use Shopify?

Copy the prompt

Copied

Find companies similar to northwind.io.

Enrich

Enrich contoso.com.

Which company is behind sam@fabrikam.com?

Copy the prompt

Copied

What email pattern does northwind.io use?

Lists and briefs

Copy the prompt

Copied

Create a list of lookalikes of our 5 best customers.

Copy the prompt

Copied

Give me a briefing on contoso.com's market and business model.

Copy the prompt

Copied

Break down my Target accounts list by industry.

SEE HOW AUTH WORKS

Each user connects their own The Companies API key once, and Scalekit sends it with every call. Keys stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

The Companies API

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

The Companies API

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

The Companies API

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

The Companies API

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other sales and search connectors.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

GTM and RevOps Teams

Competitive intelligence briefing agent

Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared The Companies API key looks fine in a demo. In production every enrichment and list change looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared key
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

The Companies API today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access The Companies API as the user or through a shared API key?

As the user. Each user connects their own The Companies API key once, and Scalekit sends it with every call. Audit logs attribute every search, enrichment, and list change to that user, not a shared service account.

Where is the The Companies API API key stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate it, the user reconnects with a new API key. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in The Companies API?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example search and enrichment without thecompaniesapi_delete_list, which deletes a company list and cannot be undone, or thecompaniesapi_request_action, which starts bulk jobs. Scalekit also enforces scope checks before every API call.

What happens when a user revokes The Companies API access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent search The Companies API in plain English?

Yes. thecompaniesapi_search_companies_by_prompt takes a description such as SaaS companies in the United States, and thecompaniesapi_generate_search_query turns a description into the filter conditions the other search tools take.