Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Use Case

Use the Search API to find people or companies using a natural language query — no manual list building required. The search runs asynchronously: you submit a query, poll for progress, and either browse results as paginated JSON or download them as a CSV. Ideal for prospecting, building targeted lead lists, or discovering contacts that match specific criteria across the web.

​
Core Concepts

TermDescription
task_idUnique identifier returned when a search starts; used to poll for status
resource_handle_idIdentifier for the result file, available once the search completes
modeSearch mode — currently "people" (default) to find individual contacts
max_resultsUpper bound on how many results to return (default: 1000)
output_modeControls result delivery — "csv" (default) produces a downloadable file, "query_only" lets you browse results as paginated JSON via /search/query
search_idIdentifier for a completed search. Use with /search/query to browse results or /search/export to generate a CSV

​
Execution Flows

​
CSV Download

  1. Start — POST /search/start-deep-search. See Start Deep Search. Submit your natural language query and receive a task_id.
  2. Poll — GET /search/status/{task_id}. See Get Search Status. Poll until status is completed; the response includes resource_handle_id.
  3. Download — GET /search/download. See Download Search Results. Request a signed URL with resource_handle_id, then download the CSV. The signed URL expires in 15 minutes.

​
Paginated JSON

  1. Start — POST /search/start-deep-search with output_mode: "query_only". See Start Deep Search. Receive a task_id.
  2. Poll — GET /search/status/{task_id}. See Get Search Status. When status is completed, note the search_id from the response.
  3. Browse — POST /search/query. See Query Search Results. Send the search_id to get paginated JSON results and use cursor for next pages.
  4. Export (optional) — POST /search/export. See Export Search Results. Generate a CSV from the same search_id.

​
Quick Start

# 1. Start a deep search
curl -X POST "https://api.sixtyfour.ai/search/start-deep-search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "VP of Engineering at Series B SaaS startups in New York",
    "mode": "people",
    "max_results": 500
  }'

# 2. Poll for status (use task_id from step 1)
curl -X GET "https://api.sixtyfour.ai/search/status/TASK_ID" \
  -H "x-api-key: YOUR_API_KEY"

# 3. Download results (use resource_handle_id from step 2)
curl -X GET "https://api.sixtyfour.ai/search/download?resource_handle_id=RESOURCE_HANDLE_ID" \
  -H "x-api-key: YOUR_API_KEY"