Request parameters
The async start response lists unrecognized body keys in
unrecognized_fields.
Tiers
Thetier 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:
"The company's primary Instagram profile URL" beats "social". For supported types and casting, see Struct & Type Casting.
Choosing related parameters
find_people vs full_org_chart
find_peoplefinds specific people at the company. Pair it withpeople_focus_promptto target roles or seniority, and withlead_structto choose what is returned for each person.full_org_chartreturns 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_planis methodology: where to look, for example"Check the About page and the LinkedIn company page".people_focus_promptis 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-asyncand pollGET /job-status/{task_id}in production.
POST /company-intelligence-async takes the same body and returns a task_id. See Async Jobs.