Cross-Entity Search | 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 company and its people (executives listed first)
response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/general/search",
    headers=headers,
    params={
        "q": "OpenAI",
        "limit": 25
    },
    timeout=30.0
)
data = response.json()
print(json.dumps(data, indent=2))

{
  "query": "OpenAI",
  "results": [
    {
      "entity_id": "019cb8ac-adee-749e-a75e-a1c236f20f72",
      "entity_type": "company",
      "display_name": "OpenAI",
      "description": "AI research and deployment company focused on ensuring artificial general intelligence benefits humanity",
      "website": "openai.com",
      "linkedin_url": "https://linkedin.com/company/openai"
    },
    {
      "entity_type": "person",
      "display_name": "Sam Altman",
      "description": "CEO at OpenAI",
      "linkedin_url": "https://linkedin.com/in/samaltman"
    }
  ],
  "total_results": 2,
  "limit": 10
}

Cross-entity search across companies and people.

Returns the company match first, then executives (C-suite) at that company, then other employees.

Supports limit parameter to control results count (default: 25, max: 100).

Authentication

AuthorizationBearer

Bearer token authentication using API key

Query parameters

limitintegerOptionalDefaults to 10

Maximum number of results to return (1�100, default: 10)

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

Errors

401

Unauthorized Error

Authentication

Headers

Query parameters

Response

Errors