People Search | Kooperativa API

POST /api/v1/people/search

Search our data lake of professional profiles using any combination of filters.

Body parameters

Parameter	Type	Description
`title`	string	Job title keywords
`location`	string or array	ISO 2-letter country code e.g. `"US"`
`seniority`	string	`c-level` · `vp` · `director` · `manager`
`company`	string	Current company name
`company_id`	string	Company ID (exact match)
`industry`	string or array	Industry name e.g. `"Computer Software"`
`headcount`	string	Company headcount range e.g. `"51 - 200"`
`skills`	array	Skill names (OR match)
`past_company`	string	Past employer name
`education`	string	School or university name
`tenure_min_months`	integer	Minimum months in current role
`job_changed_after`	integer	Unix timestamp
`exclude_companies`	array	Company names to exclude
`exclude_industries`	array	Industry names to exclude
`page`	integer	Page number (default: 1)
`per_page`	integer	Results per page (default: 10, max: 50)

Code examples

cURLbash

curl -X POST "https://kooperativa.io/api/v1/people/search" \
  -H "Authorization: Bearer ik_live_..." \
  -H "Content-Type: application/json" \
  -d '{"title": "VP of Sales", "location": "US", "seniority": "vp"}'

JavaScriptjs

const res = await fetch("https://kooperativa.io/api/v1/people/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KOOPERATIVA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ title: "VP of Sales", location: "US", seniority: "vp" }),
});
const { results, total } = await res.json();

Pythonpython

import os, requests

res = requests.post(
    "https://kooperativa.io/api/v1/people/search",
    json={"title": "VP of Sales", "location": "US", "seniority": "vp"},
    headers={"Authorization": f"Bearer {os.environ['KOOPERATIVA_API_KEY']}"},
)
data = res.json()

Response

{
  "results": [
    {
      "id": "b9847f21-...",
      "full_name": "Isaac Simpson",
      "current_title": "Chief Marketing Officer",
      "current_company": "WILL",
      "seniority": "c-level",
      "geo_city": "Los Angeles, California",
      "geo_country_code": "US",
      "linkedin_url": "https://www.linkedin.com/in/...",
      "fetched_at": "2026-06-21T17:44:00Z"
    }
  ],
  "total": 40665,
  "page": 1,
  "per_page": 10
}