> For a complete page index of the Captain API documentation, fetch https://docs.filesearch.dev/llms.txt?excludeSpec=true

# Search Deals

GET https://api.filesearch.dev/v2/datasets/odyssey/deals/search

Search funding rounds and deals by company, deal type, amount range, and date range.

Reference: https://docs.filesearch.dev/reference/datasets/odyssey/deals/deals-search

## Request

### Query parameters

- `q` (string, optional, default: ) — Search query
- `company` (string, optional, nullable) — Filter by company name
- `deal_type` (string, optional, nullable) — Filter by deal type
- `min_amount` (double, optional, nullable) — Min deal amount
- `max_amount` (double, optional, nullable) — Max deal amount
- `start_date` (string, optional, nullable) — Start date (YYYY-MM-DD)
- `end_date` (string, optional, nullable) — End date (YYYY-MM-DD)
- `page` (integer, optional, default: 1) — Page number
- `page_size` (integer, optional, default: 20) — Results per page

## Response

### 200

Successful Response

- `data_sources` (list of string, optional)
- `message` (string, optional, nullable)
- `page` (integer, optional, default: 1)
- `page_size` (integer, optional, default: 20)
- `query` (string, optional, nullable)
- `results` (list of DealSearchResult, optional)
- `total_results` (integer, optional, default: 0)

## Types

### DealSearchResult

Single search result

- `deal_id` (string, required)
- `amount` (double, optional, nullable)
- `company_name` (string, optional, nullable)
- `currency` (string, optional, nullable, default: USD)
- `deal_date` (string, optional, nullable)
- `deal_type` (string, optional, nullable)

## Examples

**Response**

```json
{
  "data_sources": [],
  "message": "No search query provided. Use ?q=CompanyName or ?company=CompanyName to search for deals.",
  "page": 1,
  "page_size": 20,
  "query": "",
  "results": [],
  "total_results": 0
}
```

**SDK Code**

```python Python REST
import requests

BASE_URL = "https://api.filesearch.dev"
API_KEY = "your_api_key"

headers = {"Authorization": f"Bearer {API_KEY}"}

response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/deals/search",
    headers=headers,
    timeout=60.0
)
print(response.json())
```

```typescript TypeScript REST
const BASE_URL = "https://api.filesearch.dev";
const API_KEY = "your_api_key";

const response = await fetch(`${BASE_URL}/v2/datasets/odyssey/deals/search`, {
    method: "GET",
    headers: { "Authorization": `Bearer ${API_KEY}` }
});
console.log(await response.json());
```