Search People | Captain Docs

import requests
import json
BASE_URL = "https://api.runcaptain.com"
API_KEY = "your_api_key"
ORG_ID = "your_organization_id"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "X-Organization-ID": ORG_ID
}
# Search for a specific person
# Pass location for better accuracy
response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/people/search",
    headers=headers,
    params={
        "q": "Felix Rieseberg",
        "location": "san francisco",
        "limit": 10
    },
    timeout=30.0
)
data = response.json()
print(json.dumps(data, indent=2))

{
  "query": "engineers at Anthropic in San Francisco",
  "results": [
    {
      "entity_id": "019d886b-c9e6-745a-b91f-d7ece19a914c",
      "full_name": "Felix Rieseberg",
      "headline": "Member of Technical Staff at Anthropic. Previously at Notion, Stripe, Slack",
      "company": "Anthropic",
      "location": "San Francisco, California, United States",
      "linkedin_url": "https://www.linkedin.com/in/felixrieseberg",
      "description": "Member of Technical Staff at Anthropic. Previously at Notion, Stripe, Slack",
      "followers": 6000,
      "school": "University of Oxford"
    },
    {
      "entity_id": "019d886b-c9f9-74f9-9939-022e77575b43",
      "full_name": "Emmanuel Ameisen",
      "headline": "Research at Anthropic. Previously Staff ML Engineer at Stripe",
      "company": "Anthropic",
      "location": "San Francisco Bay Area",
      "linkedin_url": "https://www.linkedin.com/in/ameisen",
      "description": "Research at Anthropic. Previously Staff ML Engineer at Stripe, leading ML efforts",
      "followers": 9000,
      "school": "Universit� Paris Sud"
    },
    {
      "entity_id": "019d886b-ca12-7421-8a3e-1f2e3d4c5b6a",
      "full_name": "Scott Goodfriend",
      "headline": "Research engineer working on adversarial robustness at Anthropic",
      "company": "Anthropic",
      "location": "Berkeley, California, United States",
      "linkedin_url": "https://www.linkedin.com/in/scottgoodfriend",
      "description": "Research engineer working on adversarial robustness at Anthropic",
      "followers": 527,
      "school": "UC Berkeley"
    }
  ],
  "total_results": 5,
  "limit": 5,
  "offset": 0,
  "has_more": false
}

Search for people by name, company, title, or natural language query. Returns LinkedIn profiles with rich metadata including professional headline, location, bio excerpt, follower count, and school.

Use the returned entity_id with /bio, /contact, or /education-work to get full enrichment data.

Pagination: Use offset and limit to page through results. Check has_more in the response to determine if more pages are available.

Large result sets: Supports up to 500 results per request. For requests exceeding 100 results, the API automatically expands the search with query variations to discover more profiles, then deduplicates by LinkedIn URL.

Examples:

?q=engineers at Anthropic in San Francisco&limit=20
?q=Sam Altman&limit=1
?q=senior data scientists&company=Stripe&location=New York&limit=50&offset=0

Search for people by name, company, title, or natural language query. Returns LinkedIn profiles with rich metadata including professional headline, location, bio excerpt, follower count, and school. Use the returned `entity_id` with `/bio`, `/contact`, or `/education-work` to get full enrichment data. **Pagination:** Use `offset` and `limit` to page through results. Check `has_more` in the response to determine if more pages are available. **Large result sets:** Supports up to 500 results per request. For requests exceeding 100 results, the API automatically expands the search with query variations to discover more profiles, then deduplicates by LinkedIn URL. **Examples:** - `?q=engineers at Anthropic in San Francisco&limit=20` - `?q=Sam Altman&limit=1` - `?q=senior data scientists&company=Stripe&location=New York&limit=50&offset=0`

Authentication

AuthorizationBearer

Bearer token authentication using API key

Query parameters

titlestringOptional

Filter by job title

locationstringOptional

Filter by location

limitintegerOptional1-500Defaults to 10

Maximum results per page (1-500). For limits above 100, query expansion is used automatically.

offsetintegerOptional>=0Defaults to 0

Number of results to skip for pagination. Use with limit to page through results.

Response

Successful response

querystring

The search query that was executed

resultslist of objects

Array of matching results

total_resultsinteger

Total number of matching results

limitinteger

Maximum results requested

offsetinteger

Number of results skipped (pagination offset)

has_moreboolean

Whether more results are available beyond this page

Errors

401

Unauthorized Error

Authentication

Headers

Query parameters

Response

Errors