---
title: "Search Companies"
method: GET
path: "/v2/datasets/odyssey/companies/search"
tags: ["odyssey"]
---

# Search Companies

`GET /v2/datasets/odyssey/companies/search`

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

- `q` string, required
- `limit` integer

## Response `200`

Successful Response

- CompanySearchResponse — Company search response.
  - `limit` integer
  - `query` string, required
  - `results` CompanySearchResult[]
    - `description` string, nullable
    - `employee_count` integer, nullable
    - `entity_id` string, nullable
    - `founded` integer, nullable
    - `industry` string, nullable
    - `latest_funding_stage` string, nullable
    - `linkedin_url` string, nullable
    - `location` string, nullable
    - `name` string, required
    - `size` string, nullable
    - `tags` string[], nullable
    - `total_funding_raised` number, double, nullable — Total capital raised (incl. debt). Null for large/public companies where the figure is misleading.
    - `website` string, nullable
  - `search_mode` string, nullable
  - `total_count` integer

## Other responses

- `400` — Invalid request
- `500` — Internal server error

---

[API](https://skmtc.dev/runcaptain/apis/api-reference.md) · [All operations](https://skmtc.dev/runcaptain/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runcaptain/api-reference/revisions/fe4649e3f4aa/schema)