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

Turn natural language into a targeted list of people or companies — without manual prospecting. These endpoints let you submit a query, track progress asynchronously, and either browse results as paginated JSON or download them as a CSV.

API Reference

See the full request/response schema and parameters in the API Reference.

​
Pricing

See Credits & Pricing Guide for credit costs.

​
Errors

For error responses (400, 403, 404, 409, 429, etc.), see Handling Errors.
Submit a natural language query to start an agentic search. Returns a task_id for polling. 
POST https://api.sixtyfour.ai/search/start-deep-search

​
Example request

{
  "query": "VP of Engineering at Series B SaaS startups in New York",
  "mode": "people",
  "max_results": 500
}
Save the task_id returned in the response — you’ll need it to poll for status.
Each organization can run up to 5 concurrent deep searches. Additional requests receive a 429 response until an in-flight search completes.

​
Get search status

Poll for progress and results of a running or completed search. 
GET https://api.sixtyfour.ai/search/status/{task_id}
task_id is the value returned by Start Deep Search or Export.

​
Status values

StatusDescription
queuedSearch is waiting to start.
runningSearch is actively running. Use progress_message and iterations to show progress.
completedSearch finished. resource_handle_id is available for "csv" mode. search_id can be used with /search/query in either mode.
failedSearch encountered an error — check the error field.

​
Polling recommendations

  • Poll every 10–15 seconds for active searches
  • Stop polling when status is completed or failed
  • Use progress_message to show users what the agent is currently doing
Once status is completed, use search_id with /search/query for paginated JSON, or resource_handle_id with /search/download for the CSV.

​
Download search results

Get a signed URL to download the result CSV for a completed search. 
GET https://api.sixtyfour.ai/search/download
Pass resource_handle_id (the value returned in the completed status response) as a query parameter.
The storage backend and URL format may vary. Use the url field in the response directly for downloading — it is always a valid signed URL regardless of the underlying storage provider.
Signed URLs expire after 15 minutes (900 seconds). Download the file immediately or request a new URL before it expires.

​
Query search results

Browse results from a completed deep search as paginated JSON. 
POST https://api.sixtyfour.ai/search/query
This endpoint is shared with filter search. Pass search_id to browse a completed deep search, or use simple_filters/filters/parsed_query for fresh searches. For pagination semantics, request flow, and the effective result cap, see Filter Search → Search query.

​
Example: browse deep search results

{
  "search_id": "e3b0c442-98fc-1c14-9afb-f4c8996fb924",
  "page_size": 25
}

​
Example: next page

{
  "cursor": "eyJpZCI6I..."
}
Cursor requests must send only {"cursor": "..."}. Do not include search_id, page_size, or other fields.

​
Export search results

Generate a CSV from a completed search. Runs asynchronously — poll for status, then download. 
POST https://api.sixtyfour.ai/search/export
Provide search_id to export an existing search, or parsed_query for a direct query (advanced) — not both.

​
Export flow

  1. POST to /search/export with search_id — receive task_id.
  2. Poll GET /search/status/{task_id} until completed — response includes resource_handle_id.
  3. Download via GET /search/download?resource_handle_id=....
If an export is already in progress for the given search_id, the API returns 409. Poll the existing task_id instead of starting a new export.

​
Example usage

# 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"