Search Companies | Captain Docs

{
  "query": "query",
  "limit": 1,
  "results": [
    {
      "name": "name",
      "description": "description",
      "employee_count": 1,
      "entity_id": "entity_id",
      "founded": 1,
      "industry": "industry",
      "latest_funding_stage": "latest_funding_stage",
      "linkedin_url": "linkedin_url",
      "location": "location",
      "size": "size",
      "tags": [
        "tags"
      ],
      "total_funding_raised": 1.1,
      "website": "website"
    }
  ],
  "search_mode": "search_mode",
  "total_count": 1
}

Search for companies by name or natural language description.

Supports two modes:

Direct lookup: Short queries (1-3 words) like “Stripe” or “OpenAI” resolve directly
Natural language search: Longer queries like “AI startups in San Francisco raising Series B” are translated to structured search queries and return multiple matching companies

Headers:

Authorization: Bearer {api_key}
X-Organization-ID: Organization UUID

Search for companies by name or natural language description. Supports two modes: - **Direct lookup**: Short queries (1-3 words) like "Stripe" or "OpenAI" resolve directly - **Natural language search**: Longer queries like "AI startups in San Francisco raising Series B" are translated to structured search queries and return multiple matching companies **Headers:** - `Authorization`: Bearer {api_key} - `X-Organization-ID`: Organization UUID

Query parameters

qstringRequired

Company name, domain, or natural language search query (e.g. ‘AI startups in San Francisco’)

limitintegerOptional1-25Defaults to 5

Maximum number of results (default 5)

Response

Successful Response

querystring

limitintegerDefaults to 10

resultslist of objects

search_modestring

total_countintegerDefaults to 0

Errors

400

Companies Search Request Bad Request Error

500

Companies Search Request Internal Server Error

1	import requests
2
3	url = "https://host.com/v2/datasets/odyssey/companies/search"
4
5	querystring = {"q":"q","limit":"1"}
6
7	response = requests.get(url, params=querystring)
8
9	print(response.json())