Search Deals | 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/deals/search",
    headers=headers,
    params={
        "q": "OpenAI",
    "limit": 10
    },
    timeout=30.0
)
data = response.json()
print(json.dumps(data, indent=2))

{
  "query": "OpenAI",
  "results": [
    {
      "deal_id": "deal_openai_0",
      "company_name": "OpenAI",
      "deal_date": "2024-10-02",
      "deal_type": "series_e",
      "amount": 6600000000,
      "currency": "USD"
    },
    {
      "deal_id": "deal_openai_1",
      "company_name": "OpenAI",
      "deal_date": "2023-04-28",
      "deal_type": "series_d",
      "amount": 300000000,
      "currency": "USD"
    }
  ],
  "total_results": 2,
  "page": 1,
  "page_size": 20
}

Search for funding rounds and deals by company, deal type, amount range, or date. Returns matching transactions with deal type, amount, date, and participants. Use this to find deal entity IDs for detailed lookups.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Query parameters

deal_typestringOptional

Filter by deal type (e.g., ‘series_a’, ‘series_b’, ‘seed’, ‘ipo’, ‘acquisition’, ‘debt’)

min_amountdoubleOptional

Minimum deal amount

max_amountdoubleOptional

Maximum deal amount

start_datestringOptionalformat: "date"

Start date (YYYY-MM-DD)

end_datestringOptionalformat: "date"

End date (YYYY-MM-DD)

pageintegerOptionalDefaults to 1

Page number

page_sizeintegerOptionalDefaults to 20

Results per page

Response

Successful response

querystring

The search query that was executed

resultslist of objects

Array of matching results

total_resultsinteger

Total number of matching results

pageinteger

Current page number

page_sizeinteger

Results per page

Errors

401

Unauthorized Error

Authentication

Headers

Query parameters

Response

Errors