Search Companies | 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 (supports fuzzy names like "OpenAI", domains like "stripe.com")
response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/companies/search",
    headers=headers,
    params={
        "q": "OpenAI",
    "limit": 10
    },
    timeout=30.0
)
data = response.json()
print(json.dumps(data, indent=2))

{
  "query": "Anthropic",
  "results": [
    {
      "entity_id": "019cb8ac-adee-749e-a75e-a1c236f20f80",
      "name": "Anthropic",
      "website": "anthropic.com",
      "description": "AI safety company building reliable, interpretable, and steerable AI systems",
      "employee_count": 1200,
      "industry": "artificial intelligence",
      "location": "San Francisco, California, United States",
      "founded": 2021,
      "size": "1001-5000",
      "total_funding_raised": 7300000000,
      "latest_funding_stage": "series_d",
      "tags": [
        "artificial intelligence",
        "machine learning",
        "AI safety"
      ],
      "linkedin_url": "https://linkedin.com/company/anthropic"
    }
  ],
  "total_count": 1,
  "limit": 10,
  "search_mode": "direct"
}

Search for companies by name or natural language description.

Search Modes

Direct lookup: Short queries like Stripe or OpenAI resolve to a single company match
Natural language search: Longer queries like AI startups in San Francisco raising Series B return up to 5 matching companies with surface-level data

The endpoint auto-detects which mode to use based on the query.

Response Fields

Each result includes: name, website, description, employee_count, industry, location, founded, size, total_funding_raised, latest_funding_stage, tags, and linkedin_url.

Use the entity_id or company identifier from results to call detail endpoints (bio, financing, investors, full).

Search for companies by name or natural language description. ## Search Modes - **Direct lookup**: Short queries like `Stripe` or `OpenAI` resolve to a single company match - **Natural language search**: Longer queries like `AI startups in San Francisco raising Series B` return up to 5 matching companies with surface-level data The endpoint auto-detects which mode to use based on the query. ## Response Fields Each result includes: name, website, description, employee_count, industry, location, founded, size, total_funding_raised, latest_funding_stage, tags, and linkedin_url. Use the entity_id or company identifier from results to call detail endpoints (bio, financing, investors, full).

Authentication

AuthorizationBearer

Bearer token authentication using API key

Response

Successful response

querystring

The search query that was executed

resultslist of objects

Array of matching results

total_countinteger

Total number of matching results

limitinteger

Maximum results requested

search_modestring or null

Search mode used (direct or natural_language)

Errors

401

Unauthorized Error

Search Modes

Response Fields

Authentication

Headers

Response

Errors

Search Modes

Response Fields