Skip to main content
This page uses the original routes, which keep working. For new integrations, see Company Intelligence.

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 Fields & 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.

Pricing

See Credit Costs for the price of each tier.