Candidate sourcing as an API.

# Create a search — returns 202 with a search_id
curl -s -X POST "https://api.zenithr.example/v1/candidate-searches" \
  -H "Authorization: Bearer zk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "Senior Backend Engineer",
    "locations": ["Dubai"],
    "target_count": 20
  }'

# Poll until "status" is "done"
curl -s "https://api.zenithr.example/v1/candidate-searches/SEARCH_ID" \
  -H "Authorization: Bearer zk_YOUR_API_KEY"

import requests

r = requests.post(
    "https://api.zenithr.example/v1/candidate-searches",
    headers={"Authorization": "Bearer zk_YOUR_API_KEY"},
    json={
        "role": "Senior Backend Engineer",
        "locations": ["Dubai"],
        "target_count": 20,
    },
)
search_id = r.json()["search_id"]

const res = await fetch(
  "https://api.zenithr.example/v1/candidate-searches",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer zk_YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      role: "Senior Backend Engineer",
      locations: ["Dubai"],
      target_count: 20,
    }),
  },
);
const { search_id } = await res.json();