> ## 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 company revenue signals
> Returns a company's complete revenue and profitability signal history.
Costs 10 credits per signal returned.
## What you need
A Specter company ID; get one from [Search company name](/api-reference/companies/search-company-name).
## Behaviour
- Sorted reverse-chronologically (most recent first).
- Page through with `page` and `limit`.
- Set `new=true` to return only signals from the current week (Monday onwards).
- Bound results by signal date with `revenue_signal_date_after` / `revenue_signal_date_before` (both inclusive; an explicit date overrides `new`).
- Returns `404` when the company is unknown to Specter, and `200` with an empty array when known but with no signals.
## What you do next
- **Get the company profile.** Follow the `companyId` to [Get company by ID](/api-reference/companies/get-company-by-id).
- **Open a single signal.** Pass a `signal_id` to [Get Revenue Signal by ID](/api-reference/revenue-signals/get-revenue-signal-by-id).
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /companies/{companyId}/revenue-signals
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/{companyId}/revenue-signals:
get:
tags:
- Companies
summary: Get company revenue signals
description: >
Returns a company's complete revenue and profitability signal history.
Costs 10 credits per signal returned.
## What you need
A Specter company ID; get one from [Search company
name](/api-reference/companies/search-company-name).
## Behaviour
- Sorted reverse-chronologically (most recent first).
- Page through with `page` and `limit`.
- Set `new=true` to return only signals from the current week (Monday
onwards).
- Bound results by signal date with `revenue_signal_date_after` /
`revenue_signal_date_before` (both inclusive; an explicit date overrides
`new`).
- Returns `404` when the company is unknown to Specter, and `200` with
an empty array when known but with no signals.
## What you do next
- **Get the company profile.** Follow the `companyId` to [Get company by
ID](/api-reference/companies/get-company-by-id).
- **Open a single signal.** Pass a `signal_id` to [Get Revenue Signal by
ID](/api-reference/revenue-signals/get-revenue-signal-by-id).
parameters:
- $ref: '#/components/parameters/CompanyId'
- $ref: '#/components/parameters/PaginationPage'
- $ref: '#/components/parameters/PaginationLimit'
- in: query
name: new
schema:
type: boolean
default: false
required: false
description: >
When `true`, only return signals published in the current week
(Monday onwards).
- in: query
name: revenue_signal_date_after
required: false
schema:
type: string
format: date
example: '2026-06-01'
description: >
Only return signals with a signal date on or after this date
(`YYYY-MM-DD`, inclusive). Overrides `new` when both are given.
- in: query
name: revenue_signal_date_before
required: false
schema:
type: string
format: date
example: '2026-06-30'
description: >
Only return signals with a signal date on or before this date
(`YYYY-MM-DD`, inclusive).
responses:
'200':
$ref: '#/components/responses/RevenueSignalsResponse'
'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:
CompanyId:
in: path
name: companyId
schema:
type: string
required: true
description: The Specter company ID.
PaginationPage:
in: query
name: page
schema:
type: number
required: false
description: The page number of results to return, base 0, default is 0.
PaginationLimit:
in: query
name: limit
schema:
type: number
required: false
description: The number of results to return, default is 50.
responses:
RevenueSignalsResponse:
description: List of revenue signals matching the query.
content:
application/json:
schema:
type: array
items:
$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:
- annualized_usd
- company_name
- context
- entity_id
- is_profitable
- metric
- profitability_annual_usd
- profitability_context
- profitability_reference_date
- profitability_source_article_id
- profitability_source_url
- profitability_year
- reference_date
- signal_date
- signal_id
- source_article_id
- source_type
- source_url
- tags
- traction
- whats_new
- year
properties:
signal_id:
description: Unique identifier for this revenue signal (prefixed with `rev_`).
type: string
example: rev_288a8a7b4ea68bbfd674b035bde3659b
signal_date:
description: >-
The date (YYYY-MM-DD) the underlying observation was published
(article or filing date).
type: string
format: date
example: '2025-12-16'
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: >-
Q2 rev $424K; net loss $10.8M; backlog ~$15M (+$11.2M YoY); shipped
8 WAM-V; partnerships with Mythos AI & Gradient Marine; AUVSI
certification.
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.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/
source_article_id:
description: Internal article id for the source (only set for `news` / `social`).
type: integer
example: 496721
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: 5e3bbfb900c8f4c966a2d566
company_name:
description: Name of the company the signal is attributed to.
type: string
example: Ocean Power Technologies
metric:
description: Which revenue metric the value represents.
type: string
enum:
- ARR
- Revenue
- GMV
example: Revenue
annualized_usd:
description: Annualised revenue in USD at the time of the signal.
type: number
example: 1696000
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: '2025-06-30'
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:
- ANNUALIZED
- COMPANY_REPORTED
context:
description: The text excerpt the revenue figure was extracted from.
type: string
example: >-
Fiscal Q2 2025 revenue was $424K, down from $2.4M in the prior-year
quarter; the company posted a net loss of $10.8M for the quarter;
backlog was about $15.0M at Oct. 31.
traction:
description: >-
A short qualitative traction headline associated with the signal, if
any.
type: string
example: >-
Net loss $10.8M in fiscal Q2 (vs. $3.9M prior-year), revenue
$424,000 (down from $2.4M year-over-year), backlog ~$15.0M (up
$11.2M, ~300% YoY), shipped 8 WAM-V autonomous surface vehicles,
signed strategic partnerships with Mythos AI and Gradient Marine,
AUVSI Trusted Uncrewed Maritime Systems Operator Training Provider
certification.
is_profitable:
description: >-
Whether the company is reported as profitable at the time of the
signal.
type: boolean
example: false
profitability_annual_usd:
description: Annualised net income in USD at the time of the signal.
type: number
example: -43200000
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: '2025-06-30'
profitability_context:
description: The text excerpt the profitability figure was extracted from.
type: string
example: >-
Posted a net loss of $10.8M for fiscal Q2 ended Oct. 31, 2025
(quarterly loss; annualized to -$43.2M).
profitability_source_url:
description: URL to the source backing the profitability claim.
type: string
example: >-
https://www.roi-nj.com/2025/12/16/industry/energy-utilities/ocean-power-technologies-says-government-shutdown-hurt-earnings-revenue-in-quarter/
profitability_source_article_id:
description: >-
Internal article id for the profitability source (only set for
`news` / `social`).
type: integer
example: 496721
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
````