Skip to main content

​
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 download results as a CSV once complete. 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)

​
Execution Flow

  1. Start — POST your natural language query; receive a task_id
  2. Poll — GET status until status is completed; the response will include a resource_handle_id
  3. Download — GET a signed URL using the resource_handle_id; download the CSV (URL expires in 15 minutes)

​
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/deep-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"

​
Next Steps

  • Search Endpoints — Full reference for all 3 Search endpoints with request/response schemas