Skip to main content
POST
/
v2
/
people
/
search
Search People
curl --request POST \
  --url https://api.village.do/v2/people/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Find CTOs at SaaS companies in San Francisco",
  "limit": 25,
  "high_reasoning": false,
  "cursor": "<string>",
  "network_filters": {
    "connection_degrees": [
      2
    ],
    "introducer_linkedin_ids": [
      "<string>"
    ],
    "user_to_introducer_types": [
      "direct"
    ],
    "user_to_introducer_min_score": "warm",
    "introducer_to_target_types": [
      "direct"
    ],
    "introducer_to_target_min_score": "warm",
    "exclude_teams": true,
    "exclude_community": true
  }
}
'
{
  "data": {
    "results": [
      {
        "id": "<string>",
        "full_name": "<string>",
        "first_name": "<string>",
        "last_name": "<string>",
        "linkedin_url": "<string>",
        "avatar": "<string>",
        "headline": "<string>",
        "location": "<string>",
        "company_name": "<string>",
        "company_linkedin_url": "<string>",
        "warmth_score": 123,
        "warmth_label": "<string>"
      }
    ],
    "has_next_page": true,
    "count": 123,
    "cursor": "<string>",
    "source": "network"
  },
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

Authorization
string
header
required

JWT token obtained from authentication endpoint

Body

application/json

Request body for searching people with natural language

prompt
string
required

Natural language search query

Minimum string length: 1
Example:

"Find CTOs at SaaS companies in San Francisco"

limit
integer
default:25

Maximum number of results per page

Required range: 1 <= x <= 100
Example:

25

high_reasoning
boolean
default:false

Enable high reasoning mode for more accurate results

Example:

false

cursor

Pagination cursor (encoded string or cursor object)

network_filters
object

Network filtering options for people search

Response

Search completed successfully

data
object
required

Paginated people search results

metadata
object
required