Companies
Read company facts and signals, analyze a company website, and refresh or enrich companies.
Tools (6)
Section titled “Tools (6)”analyze_company_website
Section titled “analyze_company_website”Full name: campaignstack_analyze_company_website
Renamed V2 website-analysis read for a company’s own public website. Cached analyses are reused; fresh AI extraction is credit-gated and charged to the bound workspace. Charges website_intel credits per call; campaignstack_estimate_cost gives the number before you commit.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too. |
url | string | Yes | — |
get_companies
Section titled “get_companies”Full name: campaignstack_get_companies
Read companies by ids or page workspace companies in one bounded V2 envelope. Optional includes cover signals, funding, discovery rows, employees, metric history, reviews, news, and a bounded jobs page with filters. Use nearest specialist tools for deeper company intelligence or refreshes; this read does not fetch new data. Results are one page. When pagination reports more, say so rather than presenting the page as the whole set, and page through before counting anything.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too. |
ids | string[] | No | — | Specific company IDs to hydrate. Max 25. |
query | string | No | — | Search by name prefix, domain or LinkedIn company URL across this workspace’s companies and the shared company database. Returns up to 10, each marked inWorkspace. (min length: 2, max length: 120) |
limit | integer | No | 20 | (min: 1, max: 100) |
cursor | string | No | — | |
include | object | No | {} | |
include.signals | boolean | No | false | |
include.funding | boolean | No | false | |
include.discoveries | boolean | No | false | |
include.employees | boolean | No | false | |
include.metricHistory | boolean | No | false | |
include.reviews | boolean | No | false | |
include.news | boolean | No | false | |
include.jobs | object | No | — | Include one bounded page of stored job postings for each company. Pass {} for the first page, or filters/cursor for a narrowed page. |
include.limit | integer | No | 10 | (min: 1, max: 50) |
refresh_companies
Section titled “refresh_companies”Full name: campaignstack_refresh_companies
Start a full company refresh for up to 25 companies. There is no sections argument: the backend schedules all available company-refresh components and returns per-company partial status including gates and already-queued rows. Charges company_refresh credits per call; campaignstack_estimate_cost gives the number before you commit.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too. |
companyIds | string[] | Yes | — |
enrich_companies
Section titled “enrich_companies”Full name: campaignstack_enrich_companies
Run provider firmographic enrichment for up to 25 companies. Company firmographics are shared public-domain data; provider/API-key errors are reported per company.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too. |
companyIds | string[] | Yes | — | |
provider | apollo | clay | No | "apollo" | |
clayRoutineId | string | No | — |
edit_companies
Section titled “edit_companies”Full name: campaignstack_edit_companies
Patch per-workspace company overlays (tags/notes) for up to 50 shared or private companies. This does not mutate shared firmographics.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too. |
companies | object[] | Yes | — |
lookup_company
Section titled “lookup_company”Full name: campaignstack_lookup_company
Call this when the user asks for a company that campaignstack_get_companies with a query does not find. With query, CampaignStack searches the web for matching LinkedIn company pages and returns up to 5 (companyId is set when CampaignStack already holds one). With linkedinUrl, CampaignStack reads that public company page and adds the company to the shared company database; the answer is ready with a companyId, or queued (call again with the same linkedinUrl to check), or failed. Pass exactly one of the two. Free, up to 50 searches and 50 new pages per workspace per day. It does not add the company to a campaign or reach anyone at it.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workspaceId | string | No | — | Workspace ID. Omit it when this connection reaches one workspace: a workspace key (cs_) is bound to its own, and a user key (csu_) or connected app whose person belongs to exactly one workspace defaults to that one. Required only when the person belongs to several; the error then lists them, and campaignstack_whoami reports them too. |
query | string | No | — | Company name or domain to find on LinkedIn. Returns up to 5 company pages; none is added yet. (min length: 2, max length: 120) |
linkedinUrl | string | No | — | A linkedin.com/company/ page to add. Call again with the same URL to read where the read stands. (min length: 1) |