Deep Search Overview

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

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.sixtyfour.ai"
headers = {
    "x-api-key": API_KEY,
    "Content-Type": "application/json"
}

# 1. Start the search
start_response = requests.post(
    f"{BASE_URL}/search/start-deep-search",
    headers=headers,
    json={
        "query": "VP of Engineering at Series B SaaS startups in New York",
        "mode": "people",
        "max_results": 500
    }
)
start_response.raise_for_status()
task_id = start_response.json()["task_id"]
print(f"Search started: {task_id}")

# 2. Poll until complete
while True:
    status_response = requests.get(
        f"{BASE_URL}/search/status/{task_id}",
        headers=headers
    )
    status_response.raise_for_status()
    status_data = status_response.json()

    print(f"Status: {status_data['status']} — {status_data.get('progress_message', '')}")

    if status_data["status"] == "completed":
        resource_handle_id = status_data["resource_handle_id"]
        break
    elif status_data["status"] == "failed":
        raise RuntimeError(f"Search failed: {status_data.get('error')}")

    time.sleep(10)

# 3. Get signed download URL
download_response = requests.get(
    f"{BASE_URL}/search/download",
    headers=headers,
    params={"resource_handle_id": resource_handle_id}
)
download_response.raise_for_status()
download_url = download_response.json()["url"]
print(f"Download URL: {download_url}")

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.sixtyfour.ai";
const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" };

// 1. Start the search
const startResponse = await fetch(`${BASE_URL}/search/start-deep-search`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    query: "VP of Engineering at Series B SaaS startups in New York",
    mode: "people",
    max_results: 500
  })
});
if (!startResponse.ok) throw new Error(`Failed to start: ${await startResponse.text()}`);
const { task_id } = await startResponse.json();
console.log(`Search started: ${task_id}`);

// 2. Poll until complete
let resourceHandleId;
while (true) {
  const statusResponse = await fetch(
    `${BASE_URL}/search/status/${task_id}`,
    { headers }
  );
  const statusData = await statusResponse.json();

  console.log(`Status: ${statusData.status} — ${statusData.progress_message ?? ""}`);

  if (statusData.status === "completed") {
    resourceHandleId = statusData.resource_handle_id;
    break;
  } else if (statusData.status === "failed") {
    throw new Error(`Search failed: ${statusData.error}`);
  }

  await new Promise((r) => setTimeout(r, 10000));
}

// 3. Get signed download URL
const downloadResponse = await fetch(
  `${BASE_URL}/search/download?resource_handle_id=${resourceHandleId}`,
  { headers }
);
const { url } = await downloadResponse.json();
console.log(`Download URL: ${url}`);