# searchCompanies

**Identifier:** `dealroom_searchCompanies`

**Provider:** [Dealroom](https://kirha.com/providers/dealroom.md)

Screen Dealroom companies by location, industry / technology tags, investor, labels (unicorn, vc_backed, rising_star...), founding year, funding, valuation and headcount, with total match count. Resolve location and tag IDs with resolveDealroomFilterValues first. Valuation and unicorn screens automatically apply Dealroom's default exclusions (Mature, Outside Tech, founded before 1990) and HQ-or-founding attribution, so counts match the Dealroom platform. Pass investorId to list an investor's portfolio.

## Run it with the CLI

```bash
kirha tools run dealroom_searchCompanies \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "dealroom_searchCompanies",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "cursor": {
      "description": "nextCursor of the previous page",
      "type": "string"
    },
    "foundedFromYear": {
      "maximum": 2100,
      "minimum": 1800,
      "type": "number"
    },
    "investorId": {
      "description": "Dealroom investor ID: restricts to that investor's portfolio",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
      "type": "string"
    },
    "isHiring": {
      "type": "boolean"
    },
    "labels": {
      "items": {
        "enum": [
          "unicorn",
          "vc_backed",
          "startup",
          "rising_star",
          "thoroughbred",
          "colt",
          "spinout",
          "exited",
          "pe_owned"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "number"
    },
    "locationId": {
      "description": "Country / city / region ID from resolveDealroomFilterValues",
      "type": "string"
    },
    "minEmployees": {
      "minimum": 0,
      "type": "number"
    },
    "minTotalFundingUsd": {
      "minimum": 0,
      "type": "number"
    },
    "minValuationUsd": {
      "minimum": 0,
      "type": "number"
    },
    "sortBy": {
      "default": "total_funding",
      "enum": [
        "valuation",
        "total_funding",
        "newest",
        "employees",
        "dealroom_signal"
      ],
      "type": "string"
    },
    "taxonomyIds": {
      "description": "Tag IDs from resolveDealroomFilterValues. Several IDs are combined with AND (e.g. Robotics industry AND Deep Tech)",
      "items": {
        "type": "string"
      },
      "maxItems": 4,
      "type": "array"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "companies": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "dealroomUrl": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "employees": {
            "type": "number"
          },
          "hq": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "industries": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "launchDate": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "totalFundingUsd": {
            "type": "number"
          },
          "valuationDate": {
            "type": "string"
          },
          "valuationUsd": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "ids": {
      "description": "Company IDs for getCompanyProfiles / getCompanyFundingRounds",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "nextCursor": {
      "type": "string"
    },
    "totalMatches": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "companies",
    "ids"
  ],
  "type": "object"
}
```

## Related tools

Other Dealroom tools that this tool refers to, or that refer to it.

- [`getCompanyFundingRounds`](https://kirha.com/providers/dealroom/getCompanyFundingRounds.md)
- [`resolveDealroomFilterValues`](https://kirha.com/providers/dealroom/resolveDealroomFilterValues.md)
- [`getInvestorProfile`](https://kirha.com/providers/dealroom/getInvestorProfile.md)
- [`getCompanyProfiles`](https://kirha.com/providers/dealroom/getCompanyProfiles.md)

-----

[All Dealroom tools](https://kirha.com/providers/dealroom.md) · [< Back to tools list](https://kirha.com/tools.md)