People

Search people

Changed on

Find people with a natural-language query.

post/people/search

Request

  • Base URL: https://api.context.dev/v1
  • URL: https://api.context.dev/v1/people/search
  • Auth: HTTP bearer

Request body

querystring required

Describe the people to find.

cursorstring

Use next_cursor with the same query and filters to fetch the next page.

tagsstring[]

Labels for filtering usage in the dashboard.

Example request

{
  "query": "VPs of sales at solar companies in California"
}

Response

Successful response

next_cursorstring nullable

Pass as cursor to fetch the next page; null when there are no more results.

request_idstring uuid required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example response

{
  "results": [
    {
      "name": "Alex Morgan",
      "description": "Sales leader helping solar companies grow.",
      "profiles": [
        "https://alexmorgan.example"
      ],
      "location": {
        "country_code": "US",
        "region": "California",
        "city": "San Francisco"
      },
      "role": {
        "title": "VP of Sales",
        "seniority": "executive",
        "functions": [
          "sales"
        ],
        "started_on": "2023-06-01",
        "company": {
          "name": "Solstice",
          "domain": "solstice.example"
        }
      },
      "years_of_experience": 12,
      "is_founder": false,
      "skills": [
        "Enterprise Sales",
        "Sales Leadership",
        "Renewable Energy"
      ],
      "schools": [
        "University of California, Berkeley"
      ]
    }
  ],
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"
}

Changes