> ## 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 Revenue Signal by ID
> Retrieve a single revenue (or profitability) signal by its Specter signal id (`rev_...`). Each signal corresponds to one observation derived from news coverage or a public filing — the revenue (or profitability) figures, the year they refer to, the source url, and the company they are attributed to.
Use this endpoint to look up the details of a signal referenced from another response (e.g. a list of recent revenue signals on a company).
This endpoint uses 1 credit per request.
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /revenue-signals/{signalId}
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: Enrichment
description: >
Endpoints which can be used to query for data and, if the data is not
found request that it be retrieved by Specter systems.
- name: Companies
description: >
Endpoints that provide the most up to date information about all the
companies in our data set. Giving the ability to query by a specific
company id, or using a keyword such as the domain.
This also allows us to enrich the data about a company if we either do not
have it or it is older than expected, which means you always have the most
up-to-date information possible.
- name: People
description: >
Endpoints that expose Specter people records — profile data and contact
details — for a known person ID.
- name: Investors
description: >
Endpoints that expose Specter investor records — profile, activity,
targeting, funds, portfolio companies, and the funding rounds they have
participated in — for a known investor ID.
- name: Talent and Interest Signals
description: >
Endpoints for retrieving Specter Talent Signals and Investor Interest
Signals by ID.
- name: News Signals
description: >
Company-level news signals generated from articles monitored by Specter.
Each signal represents a single classified company mention within an
article and includes a summary of the newsworthy update (such as funding,
deals, revenue, profitability, or traction) along with an assigned
importance score.
- name: Revenue Signals
description: >
Revenue and profitability observations for companies, derived from news
coverage and public filings. Each signal captures one data point — the
revenue or profitability metric, the year it refers to, the source, and
the company it is attributed to.
- name: Transactions
description: >
Endpoints that expose transaction detail — funding rounds, acquisitions,
and IPOs — by ID.
- name: Company Lists
description: >
Create, query and maintain lists of companies that are of particular
interest. The endpoints here allow you to interrogate and maintain those
lists using a programmatic interface.
- name: People Lists
description: >
Create, query and maintain lists of people that are of particular
interest. The endpoints here allow you to interrogate and maintain those
lists using a programmatic interface.
- name: Investor Lists
description: >
Create, query and maintain lists of investors that are of particular
interest. The endpoints here allow you to interrogate and maintain those
lists using a programmatic interface.
- name: Network
description: >
Endpoints for accessing your team's LinkedIn network - the people and
companies your teammates are connected to.
- name: Saved Searches
description: >
Manage searches that have been saved via `tryspecter.com`. These endpoints
are useful to programmatically list and delete saved searches. To update a
search the UI should be used at `tryspecter.com`.
- name: Company Saved Searches
description: >
Query and get results for company searches that have been saved via
`tryspecter.com`. These endpoints are useful to programmatically get
results and information for a search. To update a search the UI should be
used at `tryspecter.com`.
- name: People Saved Searches
description: >
Query and get results for people searches that have been saved via
`tryspecter.com` or via the API. These endpoints are useful to
programmatically get results and information for a search. To update a
search the UI should be used at `tryspecter.com`.
- name: Investor Saved Searches
description: >
Query and inspect saved investor searches — metadata (name, match counts)
and paginated results — from searches saved via `tryspecter.com` or shared
with the API.
- name: Talent Signals Saved Searches
description: >
Query and get results for Talent Signals searches that have been saved via
`tryspecter.com`.
- name: Investor Interest Saved Searches
description: >
Query and get results for Investor Interest Signals searches that have
been saved via `tryspecter.com`.
- name: Organization
description: >
Endpoints for accessing your organization's members and org-level
resources.
- name: Customer Data
description: >
Retrieve a log of API calls made by your organization. Useful for auditing
usage, debugging integrations, and monitoring activity.
paths:
/revenue-signals/{signalId}:
get:
tags:
- Revenue Signals
summary: Get Revenue Signal by ID
description: >
Retrieve a single revenue (or profitability) signal by its Specter
signal id (`rev_...`). Each signal corresponds to one observation
derived from news coverage or a public filing — the revenue (or
profitability) figures, the year they refer to, the source url, and the
company they are attributed to.
Use this endpoint to look up the details of a signal referenced from
another response (e.g. a list of recent revenue signals on a company).
This endpoint uses 1 credit per request.
parameters:
- $ref: '#/components/parameters/RevenueSignalId'
responses:
'200':
$ref: '#/components/responses/RevenueSignalResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/OutOfCredits'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimits'
components:
parameters:
RevenueSignalId:
in: path
name: signalId
schema:
type: string
required: true
description: The ID of the revenue signal being requested (prefixed with `rev_`).
example: rev_e3b0c44298fc1c149afbf4c8996fb924
responses:
RevenueSignalResponse:
description: The requested revenue signal.
content:
application/json:
schema:
$ref: '#/components/schemas/RevenueSignal'
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
OutOfCredits:
description: Out of credits - API credit limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
enum:
- OUT_OF_CREDITS
message:
type: string
description: |
There are no more credits available to complete the request.
headers:
X-CreditLimit-Limit:
schema:
type: integer
description: The total number of credits allocated for the current period
X-CreditLimit-Remaining:
schema:
type: integer
description: The number of credits remaining for the current period
X-CreditLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the credit limit resets
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
NotFound:
description: Not Found
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: NOT_FOUND
message:
type: string
description: Not Found
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:
RevenueSignal:
title: RevenueSignal
type: object
description: >
A single revenue (or profitability) data point observed for a company as
it's reported across social posts, news, podcasts, and public filings.
additionalProperties: false
required:
- signal_id
- source_type
- tags
properties:
signal_id:
description: Unique identifier for this revenue signal (prefixed with `rev_`).
type: string
example: rev_e3b0c44298fc1c149afbf4c8996fb924
signal_date:
description: >-
The date (YYYY-MM-DD) the underlying observation was published
(article or filing date).
type: string
format: date
example: '2025-06-15'
whats_new:
description: >
Concise summary of what is new in this signal compared to the
previous company context (e.g. "$40M ARR (2024); profitable; ...").
type: string
example: Acme Corp reported $40M ARR in their Q2 update.
source_type:
description: The kind of source the signal was derived from.
type: string
enum:
- news
- social
- public
example: news
source_url:
description: URL to the source article or filing.
type: string
example: https://www.example.com/articles/acme-q2-update
source_article_id:
description: Internal article id for the source (only set for `news` / `social`).
type: integer
example: 1234567
entity_id:
description: >
Specter company id that this signal is attributed to. May be `null`
if the company is referenced upstream but not tracked in our company
DB.
type: string
example: 66d926166261234567890123
company_name:
description: Name of the company the signal is attributed to.
type: string
example: Acme Corp
metric:
description: Which revenue metric the value represents.
type: string
enum:
- ARR
- Revenue
- GMV
example: ARR
annualized_usd:
description: Annualised revenue in USD at the time of the signal.
type: number
example: 40000000
year:
description: The fiscal year the revenue metric refers to.
type: integer
example: 2025
reference_date:
description: >
The date (YYYY-MM-DD) as of which the reported revenue figure is
valid (e.g. EOY for a yearly figure, or a specific date for an ARR
snapshot). May differ from `signal_date`.
type: string
format: date
example: '2024-12-31'
tags:
description: >
Tags qualifying the revenue figure (e.g. `PROJECTION` when the
figure is forecast rather than reported, or `public` for
SEC-filing-derived figures).
type: array
items:
type: string
example:
- PROJECTION
context:
description: The text excerpt the revenue figure was extracted from.
type: string
example: We crossed $40M in annualised recurring revenue in June.
traction:
description: >-
A short qualitative traction headline associated with the signal, if
any.
type: string
example: Customer count doubled YoY.
is_profitable:
description: >-
Whether the company is reported as profitable at the time of the
signal.
type: boolean
example: true
profitability_annual_usd:
description: Annualised net income in USD at the time of the signal.
type: number
example: 6000000
profitability_year:
description: The fiscal year the profit figure refers to.
type: integer
example: 2025
profitability_reference_date:
description: >-
The date (YYYY-MM-DD) as of which the reported profitability metric
is valid.
type: string
format: date
example: '2024-12-31'
profitability_context:
description: The text excerpt the profitability figure was extracted from.
type: string
example: Hit profitability in Q1 2025 with $1.5M net income.
profitability_source_url:
description: URL to the source backing the profitability claim.
type: string
example: https://www.example.com/articles/acme-profitability
profitability_source_article_id:
description: >-
Internal article id for the profitability source (only set for
`news` / `social`).
type: integer
example: 1234568
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
````