Documentation

Quickstart

Run your first Ask Xverum query in under a minute.

1. Get your API key

Your API key is available in your Xverum dashboard — no need to contact support. Treat it like a password — don't commit it to version control. See Authentication.

2. Make a request

curl -X POST https://search-api.xverum.com/v1/search \
  -H "x-api-key: XVERUM-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "senior Python developers with Kubernetes in Seattle"
  }'

3. Read the response

{
  "result_type": "people",
  "results": [
    {
      "id": "a1b2c3d4",
      "social_url": "https://www.linkedin.com/in/jane-doe-sea",
      "full_name": "Jane Doe",
      "headline": "Senior Python Engineer at Acme",
      "location": "Seattle, WA",
      "company_name": "Acme",
      "position": "Senior Python Engineer",
      "industry": "software",
      "evidence_summary": "Verified last 30 days"
    },
    …
  ],
  "total_count": 128,
  "page": 1,
  "page_size": 10,
  "credits_used": 1,
  "credits_remaining": 4999,
  "request_id": "8b1d4f0c12a44b7a"
}

4. Fetch a full profile

Take any id from the results and pull that person's complete profile — employment history, profile summary and seniority. One shape, 4 credits:

curl "https://search-api.xverum.com/v1/profiles/a1b2c3d4" \
  -H "x-api-key: XVERUM-API-KEY"

Next steps

See the full /v1/search reference for pagination and response fields.
Fetch profiles directly with /v1/profiles/{id}.
Understand the error model and rate limits before going to production.