> ## 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.
# Search entities by name
> Fuzzy-match one name across companies, people, and investors in a single call, with matches grouped by entity type. This is the unified replacement for the per-type name searches.
This endpoint is free — no credits are charged.
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /entities/search
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:
/entities/search:
get:
tags:
- Search
summary: Search entities by name
description: >
Fuzzy-match one name across companies, people, and investors in a single
call, with matches grouped by entity type. This is the unified
replacement for the per-type name searches.
This endpoint is free — no credits are charged.
operationId: searchEntities
parameters:
- in: query
name: query
required: true
description: Name to fuzzy-search across companies, people, and investors.
schema:
type: string
minLength: 3
- in: query
name: types
required: false
description: Entity types to search. Omit to search all three.
schema:
type: array
items:
type: string
enum:
- companies
- people
- investors
- in: query
name: limit
required: false
description: Maximum matches to return per entity type.
schema:
type: integer
default: 10
minimum: 1
maximum: 50
responses:
'200':
$ref: '#/components/responses/EntitySearchResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'422':
description: >
The request could not be processed: `query` is missing or shorter
than 3 characters, or `types` contains an unknown entity type.
'429':
$ref: '#/components/responses/RateLimits'
components:
responses:
EntitySearchResponse:
description: Matches grouped by entity type.
content:
application/json:
schema:
type: object
properties:
companies:
type: array
description: Companies whose name matches the query.
items:
$ref: '#/components/schemas/BasicCompany'
people:
type: array
description: People whose name matches the query.
items:
$ref: '#/components/schemas/EntityPersonMatch'
investors:
type: array
description: Investors whose name matches the query.
items:
$ref: '#/components/schemas/EntityInvestorMatch'
required:
- companies
- people
- investors
additionalProperties: false
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
RateLimits:
description: Too Many Requests - API Rate limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: RATE_LIMITED
message:
type: string
description: You have been rate-limited
headers:
X-RateLimit-Limit:
schema:
type: integer
description: The total rate limit allowed for this endpoint
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining
X-RateLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the rate limit resets
schemas:
BasicCompany:
type: object
properties:
id:
description: The Specter company ID; use it with the other company endpoints.
type: string
example: 5e3bc2b700c8f4c966ad2bbd
name:
description: The company's main public name.
type: string
example: Stripe
domain:
description: The domain of the website, can have a sub-domain.
type: string
example: stripe.com
hq:
$ref: '#/components/schemas/HQ'
description: The company's HQ location.
tagline:
description: A concise description of what the company does.
type: string
example: >-
Stripe provides financial infrastructure for businesses to accept
payments and grow revenue.
founded_year:
description: The year the company was founded.
type: number
nullable: true
example: 2010
match_confidence:
description: >
How closely the company matches the query, from 0 to 1. Relative to
the other results in this response; not comparable across searches.
type: number
example: 1
required:
- id
- name
- hq
- match_confidence
additionalProperties: false
EntityPersonMatch:
type: object
properties:
id:
description: The Specter person ID; use it with the other people endpoints.
type: string
example: per_5e3a8f19040ca7b0c6f03082
full_name:
description: The person's full name.
type: string
nullable: true
example: Jane Doe
headline:
description: The person's professional headline.
type: string
nullable: true
example: Co-founder & CEO at Rippling
linkedin_url:
description: The person's LinkedIn profile URL.
type: string
nullable: true
example: https://www.linkedin.com/in/jane-doe
profile_picture_url:
description: URL of the person's profile picture.
type: string
nullable: true
example: https://media.licdn.com/dms/image/jane-doe.jpg
current_company_name:
description: The name of the company the person currently works at.
type: string
nullable: true
example: Rippling
match_confidence:
description: >
How closely the person matches the query, from 0 to 1. Relative to
the other results in this response; not comparable across searches.
type: number
example: 0.82
required:
- id
- match_confidence
additionalProperties: false
EntityInvestorMatch:
type: object
properties:
id:
description: The Specter investor ID; use it with the other investor endpoints.
type: string
example: 5e3bc2b700c8f4c966ad2bbd
name:
description: The investor's main public name.
type: string
example: Sequoia Capital
domain:
description: The domain of the investor's website, can have a sub-domain.
type: string
nullable: true
example: sequoiacap.com
hq_location:
description: The investor's HQ location.
type: string
nullable: true
example: Menlo Park, California, United States
founded_year:
type: integer
nullable: true
description: The year the investor was founded.
example: 1972
type:
description: The kind of investor, such as `Venture Capital` or `Private Equity`.
type: string
nullable: true
example: Venture Capital
match_confidence:
description: >
How closely the investor matches the query, from 0 to 1. Relative to
the other results in this response; not comparable across searches.
type: number
example: 0.9
required:
- id
- name
- match_confidence
additionalProperties: false
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
HQ:
properties:
city:
description: City for the location.
type: string
example: South San Francisco
state:
description: >-
State for the location, outside of America will relate to the
country and region.
type: string
example: California
country:
description: Country for the location.
type: string
example: United States
region:
description: Use `continent` instead.
type: string
example: North America
deprecated: true
continent:
description: The continent the HQ is in.
type: string
example: North America
regions:
description: Any regions that the HQ is in.
type: array
items:
type: string
example:
- San Francisco Bay Area
required:
- city
- state
- country
- region
additionalProperties: false
title: HQ
type: object
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````