Skip to main content
Turn a company name or domain into a complete, sourced company profile, with the right contacts attached, for account research, CRM enrichment, lead qualification or diligence.

Request parameters

The async start response lists unrecognized body keys in unrecognized_fields.

Tiers

The tier parameter controls research depth and cost. Company Intelligence has no scout or xhigh tier. See People Intelligence. To investigate a company in depth, use Atlas.

Using the struct field

The struct field defines the data you want back. Each key becomes a field in structured_data, and its value tells the agent what to find. Pass a plain-English description or an object with description and type:
Specific descriptions return better results: "The company's primary Instagram profile URL" beats "social". For supported types and casting, see Struct & Type Casting.

find_people vs full_org_chart

  • find_people finds specific people at the company. Pair it with people_focus_prompt to target roles or seniority, and with lead_struct to choose what is returned for each person.
  • full_org_chart returns a compact view of employees grouped by department, capped per department. It shows broad coverage of who works where; it is not a reporting tree or an exhaustive employee list.

research_plan vs people_focus_prompt

  • research_plan is methodology: where to look, for example "Check the About page and the LinkedIn company page".
  • people_focus_prompt is criteria: who to find, for example "The VP of Marketing and the CTO".

Response

Async and timeouts

Company Intelligence runs take up to 10 minutes.
  • Set sync client timeouts to at least 15 minutes.
  • Use POST /company-intelligence-async and poll GET /job-status/{task_id} in production.
POST /company-intelligence-async takes the same body and returns a task_id. See Async Jobs.
A sync call keeps running after your client times out or disconnects, and it is charged when it finishes. A retry starts and charges a second run. Company Intelligence takes no dispatch_id, so a repeated async start also runs and charges again: keep the task_id from the first response.

Bulk

To enrich a file of companies in one job, use Bulk Intelligence.

Errors

For error responses (400, 403, 422, etc.), see Handling Errors.

Pricing

See Credit Costs for the price of each tier.