Skip to main content
POST
Start Deep Search (Async)

Authorizations

x-api-key
string
header
required

Your Sixtyfour API key.

Body

application/json

Request to start an agentic search workflow.

query
string
required

Natural-language search query.

Maximum string length: 10000
mode
enum<string>
default:people

people or company.

Available options:
people,
company
max_results
integer
default:1000

Maximum results across all pages.

search_id
string | null

A new UUID you generate for the search. Default: one is assigned.

Maximum string length: 200
output_mode
enum<string>
default:csv

csv exports the results; query_only returns only the parsed query.

Available options:
csv,
query_only
exclude_public_ids
string[] | null

People-mode inline identifiers to exclude from results, applied as a post-filter. Accepts LinkedIn public IDs or profile URLs. For company searches, use exclude_entity_ids. Max 1000.

Maximum array length: 1000
Maximum string length: 2048
exclude_entity_ids
string[] | null

Inline identifiers to exclude from results, applied as a post-filter. People mode: LinkedIn public IDs or profile URLs. Company mode: numeric LinkedIn company IDs, company URLs/slugs, or exact website domains (values that resolve to no or multiple companies are ignored). Max 1000.

Maximum array length: 1000
Maximum string length: 2048
exclude_list_ids
string[] | null

Saved exclusion-list IDs to apply as a post-filter. Each list's entity type must match the search mode (person lists for people searches, company lists for company searches). Max 5 (10 for organizations with extended exclusion limits).

Maximum array length: 10
Maximum string length: 200

Response

Successful Response

Response for starting an agentic search.

task_id
string
required

Async task ID; poll for status with this value.

status
string
required

Initial task status: running.

message
string
required

Human-readable status message.