People Search API

// API preview — endpoint and fields may change before launchconst API_BASE_URL = "/v1";const headers = {  Authorization: `Bearer ${VERONA_API_KEY}`,  "Content-Type": "application/json",  "Idempotency-Key": crypto.randomUUID(),};const searchResponse = await fetch(`${API_BASE_URL}/searches`, {  method: "POST",  headers,  body: JSON.stringify({    query: "VP-level growth leaders at AI infrastructure startups",    target_count: 250,  }),});// 202 Accepted → a durable asynchronous searchconst search = await searchResponse.json();async function waitForSearch() {  while (true) {    const statusResponse = await fetch(      `${API_BASE_URL}/searches/${search.search_id}`,      { headers },    );    const status = await statusResponse.json();    if (["completed", "failed"].includes(status.status)) {      return status;    }    await new Promise((resolve) =>      setTimeout(resolve, status.poll_after_seconds * 1_000),    );  }}// Qualified results are available while the search is still runningconst getResults = () =>  fetch(    `${API_BASE_URL}/searches/${search.search_id}/results?limit=1`,    { headers },  ).then((response) => response.json());const partialResults = await getResults();const finalStatus = await waitForSearch();const results =  finalStatus.status === "completed" ? await getResults() : partialResults;

{  "create": {    "search_id": "search_01JZ2S8YQK7M6B4F9W3H1T5N0P",    "status": "queued",    "query": "VP-level growth leaders at AI infrastructure startups",    "target_count": 250,    "qualified_count": 0,    "created_at": "2026-07-12T14:10:00Z",    "poll_after_seconds": 15,    "links": {      "status": "https://api.veronaresearch.com/v1/searches/search_01JZ2S8YQK7M6B4F9W3H1T5N0P",      "results": "https://api.veronaresearch.com/v1/searches/search_01JZ2S8YQK7M6B4F9W3H1T5N0P/results"    }  },  "status": {    "search_id": "search_01JZ2S8YQK7M6B4F9W3H1T5N0P",    "status": "running",    "query": "VP-level growth leaders at AI infrastructure startups",    "target_count": 250,    "qualified_count": 42,    "created_at": "2026-07-12T14:10:00Z",    "poll_after_seconds": 15,    "links": {      "status": "https://api.veronaresearch.com/v1/searches/search_01JZ2S8YQK7M6B4F9W3H1T5N0P",      "results": "https://api.veronaresearch.com/v1/searches/search_01JZ2S8YQK7M6B4F9W3H1T5N0P/results"    },    "current_round": 2,    "total_subagents": 8,    "successful_subagents": 6,    "goal_met": null,    "stop_reason": null,    "started_at": "2026-07-12T14:10:03Z",    "completed_at": null,    "error": null  },  "results": {    "search_id": "search_01JZ2S8YQK7M6B4F9W3H1T5N0P",    "status": "running",    "is_complete": false,    "target_count": 250,    "qualified_count": 42,    "returned_count": 1,    "has_more": true,    "next_cursor": "eyJzY29yZSI6OTYsImlkIjoxfQ",    "items": [      {        "name": "Maya Chen",        "title": "VP of Growth",        "company": "NeuralScale",        "location": "San Francisco, California, United States",        "linkedin_url": "https://www.linkedin.com/in/maya-chen",        "rationale": "Leads growth at an AI infrastructure startup and meets the requested seniority.",        "work_history": [          {            "title": "VP of Growth",            "company": "NeuralScale",            "company_domain": "neuralscale.example",            "start_date": "2023-04-01",            "end_date": null,            "is_current": true,            "location": "San Francisco, California",            "description": "Leads growth across product, lifecycle, and developer acquisition."          },          {            "title": "Director of Growth",            "company": "CloudForge",            "company_domain": "cloudforge.example",            "start_date": "2020-06-01",            "end_date": "2023-03-01",            "is_current": false,            "location": "San Francisco, California",            "description": "Built the developer acquisition engine from seed through Series B."          }        ],        "education": [          {            "school": "Stanford University",            "degree": "MBA",            "field_of_study": null,            "start_date": "2018-09-01",            "end_date": "2020-06-01"          }        ]      }    ]  }}