Skip to main content
POST
Search People

Authorizations

x-api-key
string
header
required

Your Sixtyfour API key.

Headers

Idempotency-Key
string | null
Required string length: 1 - 255

Body

application/json
filters
Filters · object | null

Filter query. Use instead of query, simple_filters, parsed_query, seeds or search_id.

simple_filters
Simple Filters · object | null

Filters with Mongo-style operators. Use instead of query, filters, parsed_query, seeds or search_id.

parsed_query
Parsed Query · object | null

Structured filter set from a previous Search result. Use instead of query, filters, simple_filters, seeds or search_id.

query
string | null

Natural-language description of matching records. Use instead of filters, simple_filters, parsed_query, seeds or search_id.

Required string length: 1 - 10000
seeds
(object | string)[] | null

Example people to find similar profiles, up to 1,000 records. Only for people search; use instead of filters, query or search_id.

Required array length: 1 - 1000 elements
search_id
string | null

Saved search to run. Use instead of filters, simple_filters, parsed_query, query or seeds.

Required string length: 1 - 200
cursor
string | null

Exclusive cursor returned by a previous paged Search result. Send it alone to continue that search.

Required string length: 1 - 2048
page_size
integer | null

Return one page of this many records. Use instead of the bulk Job result. Range: 1 to 100.

Required range: 1 <= x <= 100
max_results
integer | null
default:10

Maximum records across all pages. Bulk default: 10. For a paged Search, omission uses the caller's Search limit.

Required range: x >= 1
query_mode
enum<string> | null

For natural-language queries, standard uses the existing filter planner; deep uses deep research. Omission preserves the deep-search default.

Available options:
standard,
deep
output_shape
enum<string> | null

Shape of returned rows. Paged Search defaults to raw; bulk Search retains workflow rows.

Available options:
raw,
workflow
exclude_list_ids
string[] | null

Lists whose members to exclude. Omit to exclude none. Limit: 5 by default, up to 10 with a higher organization limit.

Maximum array length: 10
Maximum string length: 200
exclude_entity_ids
string[] | null

Identifiers to exclude as a post-filter. People mode accepts LinkedIn public IDs or profile URLs; company mode accepts LinkedIn company IDs, company URLs or domains. Up to 1,000 values.

Maximum array length: 1000
Maximum string length: 2048
location_expansion_enabled
boolean | null

If true, also matches places near a location in query. If false, matches only the location given. Default: true.

expand_structured_location
boolean
default:false

Expand structured location filters before matching nearby places.

location_expansion_radius_miles
integer
default:10

Search radius for location expansion, in miles. Range: 5 to 200.

Required range: 5 <= x <= 200
wait_seconds
integer
default:5

Seconds to wait for the Job to finish. Default: 5. Range: 0 to 20.

Required range: 0 <= x <= 20
webhook_url
string<uri> | null

HTTPS URL to notify when the Job finishes. Omit to use polling.

Required string length: 1 - 2048

Response

Job finished within the wait window.

job_id
string
required

Job identifier, normally prefixed with job_. Store it exactly as returned. GET /v1/jobs/{job_id} also accepts IDs returned by unversioned endpoints.

status
enum<string>
required

Current Job status. Stop polling on succeeded, failed or canceled.

Available options:
queued,
running,
succeeded,
failed,
canceled
created_at
string<date-time>
required

UTC timestamp when the job was created, in ISO 8601 format.

operation
enum<string>
required

Action performed by the Job.

Available options:
people.search,
companies.search,
people.contacts,
people.contacts.reverse,
people.intelligence,
companies.intelligence,
lists.create,
exports.create,
workflows.run,
qa-agent.run,
verify-age.run
next_poll_after
integer | null

Seconds before the next poll. Present only while the Job is queued or running.

progress
Progress · object | null

Operation-specific progress while queued or running; omitted when unavailable.

result
SearchResult · object | null

Native Search metadata and, for paged Search, the raw rows in items.

Example:
error
JobError · object | null

Failure details when available; omitted otherwise.

counts
JobCounts · object | null

Input record counts, when available.

charge_credits
number | null

Net credits captured at retrieval, including refunds. May change after the Job finishes; null when unavailable, unknown, or withheld by spend permissions.