Search People

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 company (supports fuzzy names like "OpenAI", domains like "stripe.com")
response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/people/search",
    headers=headers,
    params={
        "q": "OpenAI",
    "limit": 10
    },
    timeout=30.0
)
data = response.json()
for company in data.get("results", []):
    print(f"{company['name']} ({company['entity_id']})")

{
  "query": "Sam Altman",
  "results": [
    {
      "entity_id": "ody_pe_019cb8ac-f123-749e-a75e-e5f669g53c05",
      "full_name": "Sam Altman",
      "headline": "CEO at OpenAI",
      "company": "OpenAI",
      "location": "San Francisco, California, United States",
      "linkedin_url": "https://linkedin.com/in/samaltman"
    }
  ],
  "total_results": 1,
  "limit": 10
}

Search for professionals by name, company, title, or location. Returns matching profiles with current position, company, and LinkedIn URL. Use this to find person entity IDs for detailed lookups.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Query parameters

titlestringOptional

Filter by job title

locationstringOptional

Filter by location

limitintegerOptionalDefaults to 10

Maximum results

Response

Successful response

Authentication

Headers

Query parameters

Response

Errors