Skip to main content
Company Intelligence researches one company and returns the fields you name. It can also find the people who work there. For a file of companies, use Bulk Intelligence.

Request

Response

Your request returns a Job. When a single-company Job reaches succeeded, its result holds the researched fields. For a batch, or to read the same record as an item, use GET /v1/jobs/{job_id}/items. If you requested people, each result also includes leads.
Item response

People returned in leads

Parameters

Send exactly one of company, companies or input_file_id.
object
Known information about the company, such as name, domain, website, linkedin or location.
object[]
Companies to research. From 1 to 100,000 records.
string
Uploaded file of companies. Use instead of company or companies.
object
required
Fields to return. See Field descriptions.
string
required
Research depth. See Tiers.
string
Where and how to research. Maximum 100,000 characters.
boolean
default:false
If true, finds people at the company and returns them in leads. If false, researches the company only.
string
Roles or people to find. Only with find_people: true. Maximum 10,000 characters.
boolean
default:false
If true, requests the full company org chart and includes it in org_chart when available. If false or omitted, does not request the full chart.
boolean
default:false
If true, scores each researched field from 0 to 100 and includes a justification and source URLs in enrichment_field_confidence. If false or omitted, does not enable additional field scoring. See Confidence Scoring.
integer
default:5
Seconds to wait for the Job to finish, from 0 to 20.
string
HTTPS callback URL. See Outgoing Webhooks.
Set custom_id on each record to match the result to your own records.

Tiers

For deeper company investigations, use Atlas.

Field descriptions

Specify each output field under fields. Use a description string or an object with description and type.
Describe the value you need: "The company's primary Instagram profile URL" instead of "social". Set a type when your code depends on the shape of the value: See Fields & Type Casting for every type, nested objects and missing values.

Try it

Open the Company Intelligence API Reference playground.
For older requests and options, see Legacy Company Intelligence.