Search Deals

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()
for company in data.get("results", []):
    print(f"{company['name']} ({company['entity_id']})")

{
  "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

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

Authentication

Headers

Query parameters

Response

Errors