Skip to main content
People Intelligence researches one person and returns the fields you name. Send what you know, such as a name and company or a LinkedIn URL, and describe each field you want back. For a file of people, use Bulk Intelligence.

Request

Response

Your request returns a Job. When a single-person 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.
Item response

Parameters

Send exactly one of person, people or input_file_id.
object
Known information about a person. Accepts any attributes, including name, company, email, linkedin_url and location.
object[]
People to research. From 1 to 100,000 records.
string
Uploaded file of people. Use instead of person or people.
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, 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. The xhigh tier can return field confidence from its research when available, regardless of this option. 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

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 person's primary work email" instead of "email". 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.

Image fields

On high and xhigh, request a headshot with {"headshot": "A recent photo of the person"} in fields. The item’s result.headshot is a link to the image. Media links work while Sixtyfour retains your data. They need no API key unless your organization uses customer-managed encryption. See Legacy media options for access details and PDF captures.

The xhigh tier

xhigh uses the Atlas investigation engine for extended research. Allow more time than for other tiers. Its result adds two fields: See Atlas for budgets, continuing research and reports.

Try it

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