View as Markdown
Super Carl icon

Super Carl ACTION

Search Companies

Search companies by name, domain, funding, size, industry, location, growth, or technology. Use this to qualify a target company or find companies matching structured Filters before reaching out. Use Search People afterward to find people at a matched company; enable Resolve Only to just disambiguate a single company name, domain, or LinkedIn URL without running a full search — Resolve Only returns identity metadata ONLY (name, domain, a coarse employee_count, industries), never a company's real size or description. When the task needs to know a company's actual size or what it does, leave Resolve Only off (or set it false) and set Result Mode to detailed; don't fill gaps from outside knowledge when Resolve Only comes back thin — re-call with detailed instead. Company rows in detailed mode can be large — pass Fields (e.g. name, domain, employee_count) to keep the result small. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Super Carl account once, then configure and run Search Companies from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "super_carl-search-companies",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    super_carl: { authProvisionId: "apn_xxxxxxx" },
    query: "Query",
    filters: "Filters",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Companies inputs
Property Type Description
query Query string
Natural-language search query, for example Head of Growth candidates in NYC warm through my network.
Optional
filters Filters object
Optional Super Carl AdvancedFilters JSON object for structured constraints. Example: { "job_titles": { "include": ["Head of Growth"], "current_only": true }, "locations": { "include": ["New York"] }, "connection_degrees": ["1st"] }.
Optional
previewLimit Preview Limit integer
Maximum number of preview rows to return.
Optional
resolveOnly Resolve Only boolean
Return only company disambiguation metadata for a named company, domain, or LinkedIn company URL. Example query values: stripe.com, https://www.linkedin.com/company/stripe, or Stripe.
Optional
resultMode Result Mode string
Level of company-row detail to return. Use preview for fast, compact rows, or detailed when the workflow needs richer company metadata.
Optional
includeEvidenceText Include Evidence Text boolean
Include supporting evidence text on company rows when available.
Optional
delegateUserId Delegate User ID string
Optional Super Carl team-seat user ID to search as. This is the UUID of a teammate's user record that the API key owner can delegate to, for example 550e8400-e29b-41d4-a716-446655440000.
Optional
fields Fields string[]
Optional list of fields to return per row instead of the full record — keeps large result sets well under the context limit. Supports dot-paths for nested values, for example name, linkedin_profile_url, resolved_target.id. Omit this prop to return the API default field set (every field).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
super_carl-search-companies
Version
0.0.2
App
Super Carl
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes