Look up contacts from a file
- Save your records as CSV, JSON, JSONL or NDJSON.
- Upload the file to get a
file_id. - Start a Job with
input_file_id. - Poll the Job and read its items.
- Export the results and download the file.
Prepare the input records
Save this aspeople.csv:
custom_id to match each result to your records. Files support up to 100,000 rows.
Upload and start
ReplaceYOUR_API_KEY with your API key. Python uses requests; cURL uses jq; JavaScript uses Node.js 18 or later.
HTTP 200 (excerpt)
Check the Job
Continue with the Job from the start request:Read the items
next_cursor unchanged for more pages. See Read every item.
Download the results
Use the shared export and download flow with the completed Job’s ID asfrom.job_id.
Research records from a file
UsePOST /v1/people/intelligence or POST /v1/companies/intelligence with input_file_id, tier and fields to research each record. See Bulk Intelligence.
Send inline records
Usepeople for Contacts or People Intelligence and companies for Company Intelligence instead of uploading a file.
Run a workflow batch
For editor batches, rows from your own systems and custom processing, see Workflow Batches.Related
For older bulk contact requests, see Legacy.