Tool catalog

Superdata exposes 35 native tools for company and people discovery, composed research, market analysis, contact enrichment, LinkedIn research, async jobs, and interactive results. The three progressive tools preserve access to supported long-tail intelligence operations without loading every raw schema into the client at once.

Primary direct tools

Tool	Purpose	Credit cost
`superdata_search_companies`	Search companies with bounded pagination and sorting	1
`superdata_match_company`	Resolve a company from its name, domain, or LinkedIn URL	1
`superdata_get_company`	Retrieve one company overview	1
`superdata_search_people`	Search public professional profiles without contact enrichment	1
`superdata_find_company_people`	Find current profiles at one company with title, skill, and country filters	1
`superdata_get_company_trends`	Retrieve bounded employee and follower trend points	1
`superdata_match_person`	Resolve a professional identity	1
`superdata_get_person`	Retrieve one professional profile	1
`superdata_resolve_person_from_social_url`	Resolve a person from a public social-profile URL	1
`superdata_reveal_work_email`	Find licensed work-email candidates when explicitly requested	1
`superdata_validate_email`	Validate an explicitly supplied email address	1
`superdata_get_linkedin_profile`	Retrieve cached or refreshed LinkedIn profile data	1
`superdata_get_linkedin_profile_posts`	Retrieve posts from a public LinkedIn profile	1
`superdata_get_linkedin_company`	Retrieve cached or refreshed LinkedIn company data	1
`superdata_get_linkedin_company_posts`	Retrieve posts from a public LinkedIn company page	1
`superdata_get_linkedin_job`	Retrieve one LinkedIn job posting	1

Composed research and enrichment

Tool	Purpose	Credit cost
`superdata_find_decision_makers`	Rank buying-committee members across named companies with separate fit, confidence, and evidence	Estimate: 0; execute: published range
`superdata_research_company`	Build a company brief from identity, growth, team, technology, and activity evidence	Estimate: 0; execute: published range
`superdata_enrich_people`	Enrich up to 25 explicit professional identities and report per-record status	1
`superdata_find_work_email`	Find and optionally verify a licensed business email for an explicit person	1

The two composed research tools accept estimate, preview, and execute modes. Estimate mode returns a cost and latency range without provider work. Large executions can return an async job instead of holding one request open.

Market and fit analysis

Tool	Purpose	Credit cost
`superdata_analyze_company_growth`	Calculate covered workforce growth over a requested date window	1
`superdata_analyze_team_composition`	Summarize observed team counts and shares	1
`superdata_analyze_jobs`	Compare title demand across explicit public job postings	1
`superdata_find_similar_companies`	Rank peer companies with visible similarity dimensions	1
`superdata_analyze_technology`	Combine covered web technology and mobile SDK evidence	1
`superdata_build_icp`	Build a deterministic ICP from supplied canonical companies	0
`superdata_score_fit`	Score one canonical company against an ICP with separate evidence confidence	0

Async jobs

Tool	Purpose	Credit cost
`superdata_get_job_status`	Read workspace-isolated progress, terminal state, and the completed result resource	0

Poll using the server-provided interval. Completed results are available only to the authenticated workspace that created the job. Every other catalog capability remains available through progressive discovery. This includes workforce, audiences, jobs, identity, bulk operations, iOS and Android apps, rankings, SDKs, websites, web technologies, search, and social intelligence.

Presentation tools

superdata_render_people_results, superdata_render_company_results, superdata_render_jobs_results, and superdata_render_company_brief turn normalized findings into interactive result cards. Presentation tools are read-only and do not consume credits.

Progressive fallback

Tool	Purpose	Credit cost
`superdata_search_capabilities`	Search the capability catalog	0
`superdata_get_capability`	Inspect one capability contract	0
`superdata_call`	Execute one capability	1 on success or no match

`superdata_search_capabilities`

Search the catalog by natural-language intent or exact category when the appropriate direct tool is not already clear.

Inputs

Field	Type	Required	Rules
`query`	string	No	Natural-language capability search, up to 500 characters
`category`	string	No	Exact category returned by this tool
`limit`	integer	No	1–50; defaults to 15
`detail`	`names` or `summaries`	No	Defaults to `summaries`

{
  "query": "company employee growth",
  "category": "companies",
  "limit": 10,
  "detail": "summaries"
}

The response contains the available categories, match count, and matching capabilities. Each match includes its exact name, title, category, and an optional description.

`superdata_get_capability`

Inspect the contract for one exact capability name returned by superdata_search_capabilities.

Inputs

Field	Type	Required	Rules
`name`	string	Yes	Exact capability name from discovery

{
  "name": "companies_get"
}

The response includes the HTTP method, path template, required path parameters, category, read-only status, execution tool, and credit cost. Discovery and inspection do not consume credits.

`superdata_call`

Execute one capability selected through discovery. Do not invent operation names, path parameters, or taxonomy identifiers.

Inputs

Field	Type	Required	Rules
`operation`	string	Yes	Exact capability name returned by discovery
`path`	object	No	Values for every placeholder in the capability path template
`query`	object	No	Case-sensitive query parameters for the selected operation
`body`	JSON value	No	Request body for supported `POST` operations
`confirmMutation`	boolean	No	Must be `true` for a capability that changes external state
`maxResponseBytes`	integer	No	1,024–1,000,000; defaults to 250,000

{
  "operation": "companies_get",
  "path": {
    "company_id": 123456
  },
  "query": {},
  "confirmMutation": false
}

A successful response contains:

ok: true
The executed operation
Upstream statusCode and contentType
Parsed provider data
responseBytes and a truncated indicator
creditsConsumed: 1

An unsuccessful response contains ok: false and a public error with code, message, and an optional upstream statusCode. Failed execution restores the reserved credit.

Only set confirmMutation: true after reviewing the selected capability and approving the external change. This includes operations that submit, ingest, prioritize, redact, or delete data.

Capability areas

The catalog covers company and people intelligence, LinkedIn, email, technology and SDK signals, mobile applications, search results, taxonomy, segments, identity, privacy, and account usage. Search the live catalog rather than relying on a static list because available capabilities can change. For taxonomy-backed operations, run segments_search_features first and use the returned identifiers exactly as provided.

Getting started

Using Superdata

Governance

Manage

Primary direct tools

Composed research and enrichment

Market and fit analysis

Async jobs

Presentation tools

Progressive fallback

`superdata_search_capabilities`

Inputs

`superdata_get_capability`

Inputs

`superdata_call`

Inputs

Capability areas

​Primary direct tools

​Composed research and enrichment

​Market and fit analysis

​Async jobs

​Presentation tools

​Progressive fallback

​superdata_search_capabilities

​Inputs

​superdata_get_capability

​Inputs

​superdata_call

​Inputs

​Capability areas

Primary direct tools

Composed research and enrichment

Market and fit analysis

Async jobs

Presentation tools

Progressive fallback

`superdata_search_capabilities`

Inputs

`superdata_get_capability`

Inputs

`superdata_call`

Inputs

Capability areas