Bulk get similar companies by ID

curl --request POST \
  --url https://app.tryspecter.com/api/v1/companies/similar/by-id/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_ids": [
    "5e3a7f2b0aa7a3270a55f2b9",
    "5e3a7f2b0aa7a3270a55f2a8"
  ],
  "limit_per_seed": 5
}
'

[
  {
    "company_id": "5e3a7f2b0aa7a3270a55f2b9",
    "similar_company_ids": [
      "5e3a7f2b0aa7a3270a55f2a8"
    ]
  }
]

Companies

Bulk get similar companies by ID

Find lookalike companies for up to 50 seed companies in a single request. This is the bulk counterpart to GET /companies/{companyId}/similar — pass a list of seed company IDs and get back the similar company IDs for each.

Each result pairs a seed company_id with the similar_company_ids matched for it (which may be empty). Unknown seed IDs are omitted; the response order is not guaranteed.

This endpoint uses 1 credit per resolved seed company returned.

POST

companies

similar

by-id

bulk

Bulk get similar companies by ID

curl --request POST \
  --url https://app.tryspecter.com/api/v1/companies/similar/by-id/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_ids": [
    "5e3a7f2b0aa7a3270a55f2b9",
    "5e3a7f2b0aa7a3270a55f2a8"
  ],
  "limit_per_seed": 5
}
'

[
  {
    "company_id": "5e3a7f2b0aa7a3270a55f2b9",
    "similar_company_ids": [
      "5e3a7f2b0aa7a3270a55f2a8"
    ]
  }
]

Authorizations

X-API-Key

string

header

required

Body

application/json

company_ids

string[]

required

External Specter company IDs to find lookalikes for.

Required array length: 1 - 50 elements

growth_stage

string[]

Optional growth-stage filter applied to all seeds.

limit_per_seed

integer

default:10

Maximum number of similar companies returned per seed.

Required range: 1 <= x <= 100

Response

For each resolved seed company, the IDs of its similar companies.

company_id

string

The seed company ID.

Example:

"5e3a7f2b0aa7a3270a55f2b9"

similar_company_ids

string[]

IDs of companies similar to the seed (may be empty).