/api/v1/companies/:domain/similarSimilar
Returns companies similar to the given company, ranked by cosine similarity, along with the source company and metadata about the result set. Use it to find comparable or related companies from a known domain. Fails with 404 if the company does not exist or has no similarity data available yet, 400 for invalid query parameters, and 503 if similarity search is temporarily unavailable.
When to use it
- Find companies similar to a known company
- Discover comparable businesses by domain
- Expand a company list with lookalikes
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Rate limit
Every call counts against your workspace’s daily quota for company-similar. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 10 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain(path) | string | Yes | Company domain used to identify the source company. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Maximum number of similar companies to return. (range 1-50; default 10) Range: 1 to 50 |
| min_similarity | number | No | Minimum cosine similarity a company must reach to be included. (range -1-1) Range: -1 to 1 |
| sector | string | No | Restrict results to companies in this sector. |
| country | string | No | Restrict results to companies in this country. |
| status | string | No | Restrict results to companies with this status. |
| include_embedding | boolean | No | When true, include each result's similarity vector in the response. |
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/companies/{domain}/similar"Response envelope
This endpoint returns an implicit 2xx response - there is no success flag in the body.
{
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}
// No "success" flag on this endpoint - any 2xx JSON is a success.Catalog version mcp-2026-10-28 · generated from the live MCP catalog