> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get similar companies (bulk)
> Find companies similar to each of up to 50 companies in one request, the bulk counterpart to [Get similar companies](/api-reference/companies/get-similar-companies). Pass a list of company IDs and get back the similar company IDs for each.
Costs 1 credit per resolved company returned.
## What you need
Up to 50 seed `companyId`s (get them with [Find company ID](/api-reference/companies/find-company-id) or [Search company name](/api-reference/companies/search-company-name)).
## Behaviour
- Each result pairs a company ID you passed with its `similar_company_ids` (which may be empty).
- Unknown company IDs are omitted, and the response order isn't guaranteed.
- Filter all input companies by growth stage with the optional `growth_stage` parameter.
- `limit_per_seed` caps the number of similar companies per input company (default 10, max 100).
## What you do next
- **Profile the lookalikes.** Follow each returned `id` to [Get company by ID](/api-reference/companies/get-company-by-id).
- **Compare with direct competitors.** Pull a ranked set rather than algorithmic similarity with [Get company competitors](/api-reference/companies/get-company-competitors).
- **For a single seed.** To find lookalikes for one company, use [Get similar companies](/api-reference/companies/get-similar-companies).
## OpenAPI
````yaml /api-ref/bundle_api.yaml post /companies/similar/by-id/bulk
openapi: 3.0.0
info:
title: Specter API
termsOfService: https://tryspecter.com/terms/
contact:
name: API support
email: api-support@tryspecter.com
version: 1.0.0
servers:
- description: Production
url: https://app.tryspecter.com/api/v1
security:
- ApiKeyAuth: []
tags:
- name: Enrich
description: >
Look up a company, person, or investor and, if Specter does not already
hold it, fetch it on demand. Includes email-based person enrichment.
- name: Search
description: |
Find records across every product from a single plain-English query.
- name: Companies
description: >
Company profiles, funding, headcount, traction, the per-company signals
and sub-resources attached to a single company, and identifier resolution.
- name: People
description: >
Specter people records: profile data, contact details, and per-person
lookups for a known person ID.
- name: Investors
description: >
Specter investor records: profile, activity, targeting, funds, portfolio
companies, and the funding rounds they have participated in.
- name: Transactions
description: |
Transaction detail by ID: funding rounds, acquisitions, and IPOs.
- name: News Signals
description: |
Company-level news signals: by ID, and for a saved list or company search.
- name: Revenue Signals
description: >
Revenue and profitability signals: by ID, by date, and for a saved list or
company search.
- name: Talent Signals
description: |
Talent signals: by ID and in bulk by ID.
- name: Investor Interest Signals
description: |
Investor interest signals: by ID and in bulk by ID.
- name: Company Lists
description: |
Create, query, and maintain lists of companies, including their results.
- name: Investor Lists
description: |
Create, query, and maintain lists of investors, including their results.
- name: People Lists
description: |
Create, query, and maintain lists of people, including their results.
- name: Saved Searches
description: |
List and delete searches saved via tryspecter.com.
- name: Company Saved Searches
description: |
Details and results for saved company searches.
- name: People Saved Searches
description: |
Details and results for saved people searches.
- name: Investor Saved Searches
description: |
Details and results for saved investor searches.
- name: Talent Signals Saved Searches
description: |
Details and results for saved Talent Signals searches.
- name: Investor Interest Saved Searches
description: |
Details and results for saved Investor Interest Signals searches.
- name: Network
description: >
Your team's LinkedIn network: the people and companies your teammates are
connected to, and your reach into a given company.
- name: Account
description: >
Organisation-level resources: your team's members, API call logs, and
credit balance.
paths:
/companies/similar/by-id/bulk:
post:
tags:
- Companies
summary: Get similar companies (bulk)
description: >
Find companies similar to each of up to 50 companies in one request, the
bulk counterpart to [Get similar
companies](/api-reference/companies/get-similar-companies). Pass a list
of company IDs and get back the similar company IDs for each.
Costs 1 credit per resolved company returned.
## What you need
Up to 50 seed `companyId`s (get them with [Find company
ID](/api-reference/companies/find-company-id) or [Search company
name](/api-reference/companies/search-company-name)).
## Behaviour
- Each result pairs a company ID you passed with its
`similar_company_ids` (which may be empty).
- Unknown company IDs are omitted, and the response order isn't
guaranteed.
- Filter all input companies by growth stage with the optional
`growth_stage` parameter.
- `limit_per_seed` caps the number of similar companies per input
company (default 10, max 100).
## What you do next
- **Profile the lookalikes.** Follow each returned `id` to [Get company
by ID](/api-reference/companies/get-company-by-id).
- **Compare with direct competitors.** Pull a ranked set rather than
algorithmic similarity with [Get company
competitors](/api-reference/companies/get-company-competitors).
- **For a single seed.** To find lookalikes for one company, use [Get
similar companies](/api-reference/companies/get-similar-companies).
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- company_ids
properties:
company_ids:
type: array
minItems: 1
maxItems: 50
description: Specter company IDs to find lookalikes for.
items:
type: string
example: 5e3a8f19040ca7b0c6f03082
growth_stage:
type: array
description: >
Optional growth-stage filter applied to all companies.
Accepts the same stages as [Get similar
companies](/api-reference/companies/get-similar-companies).
items:
type: string
example: late
limit_per_seed:
type: integer
default: 10
minimum: 1
maximum: 100
description: >-
Maximum number of similar companies returned per input
company.
example:
company_ids:
- 5e3bc2b700c8f4c966ad2bbd
- 5e3bc1b900c8f4c966a99aaa
- 620b43e6d1fb898462f893b8
limit_per_seed: 5
responses:
'200':
description: For each company you passed, the IDs of its similar companies.
content:
application/json:
schema:
type: array
items:
type: object
properties:
company_id:
type: string
description: The company ID you passed.
example: 5e3a8f19040ca7b0c6f03082
similar_company_ids:
type: array
description: IDs of companies similar to it (may be empty).
items:
type: string
example: 6363797eaab093538e0beb3c
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
components:
responses:
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
Forbidden:
description: Forbidden - There is no permissions to use the endpoint
content:
application/json:
schema:
type: object
properties:
errorCode:
description: NOT_PERMITTED
type: string
example: NOT_PERMITTED
message:
type: string
description: You do not have permission to access this resource.
example: You do not have permission to access this resource.
required:
- errorCode
- message
schemas:
ApiKeyMissing:
properties:
errorCode:
description: API_KEY_MISSING
example: API_KEY_MISSING
type: string
message:
description: No API Key was presented on the header X-API-KEY
example: No API Key was presented on the header X-API-KEY
type: string
ApiKeyNotValid:
properties:
errorCode:
description: API_KEY_NOT_VALID
example: API_KEY_NOT_VALID
type: string
message:
description: API key present, but not valid
example: API key present, but not valid
type: string
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````