Get Revenue Signals for a company list

curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "signal_id": "rev_288a8a7b4ea68bbfd674b035bde3659b",
    "signal_date": "2025-12-16",
    "whats_new": "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": "news",
    "source_url": "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": 496721,
    "entity_id": "5e3bbfb900c8f4c966a2d566",
    "company_name": "Ocean Power Technologies",
    "metric": "Revenue",
    "annualized_usd": 1696000,
    "year": 2025,
    "reference_date": "2025-06-30",
    "tags": [
      "ANNUALIZED",
      "COMPANY_REPORTED"
    ],
    "context": "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": "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": false,
    "profitability_annual_usd": -43200000,
    "profitability_year": 2025,
    "profitability_reference_date": "2025-06-30",
    "profitability_context": "Posted a net loss of $10.8M for fiscal Q2 ended Oct. 31, 2025 (quarterly loss; annualized to -$43.2M).",
    "profitability_source_url": "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": 496721
  }
]

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Revenue Signals

Get Revenue Signals for a company list

Returns revenue signals for the companies in a list.

Costs 10 credits per signal returned.

What you need

A company list ID that has been shared with the API; get one from Get all company lists.

Behaviour

Scoped to the list’s member companies; for every revenue signal across all companies use Get revenue signals by date.
Page through with page and limit.
Set new=true to return only signals published in the current week (Monday onwards).
Lists with more than 5,000 member companies are capped at that limit to keep the revenue-signal join tractable.
Returns 404 when the list doesn’t exist or isn’t visible to the caller (including lists for non-company products).

What you do next

Open a single signal. Pass a signal_id to Get Revenue Signal by ID.
Open the company. Follow a signal’s entity_id to Get company by ID.

GET

lists

companies

{listId}

revenue-signals

Get Revenue Signals for a company list

curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/lists/companies/{listId}/revenue-signals")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "signal_id": "rev_288a8a7b4ea68bbfd674b035bde3659b",
    "signal_date": "2025-12-16",
    "whats_new": "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": "news",
    "source_url": "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": 496721,
    "entity_id": "5e3bbfb900c8f4c966a2d566",
    "company_name": "Ocean Power Technologies",
    "metric": "Revenue",
    "annualized_usd": 1696000,
    "year": 2025,
    "reference_date": "2025-06-30",
    "tags": [
      "ANNUALIZED",
      "COMPANY_REPORTED"
    ],
    "context": "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": "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": false,
    "profitability_annual_usd": -43200000,
    "profitability_year": 2025,
    "profitability_reference_date": "2025-06-30",
    "profitability_context": "Posted a net loss of $10.8M for fiscal Q2 ended Oct. 31, 2025 (quarterly loss; annualized to -$43.2M).",
    "profitability_source_url": "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": 496721
  }
]

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

listId

string<uuid>

required

The ID of the list being requested.

Query Parameters

page

number

The page number of results to return, base 0, default is 0.

limit

number

The number of results to return, default is 50.

new

boolean

default:false

When true, only return signals published in the current week (Monday onwards).

Response

List of revenue signals matching the query.

signal_id

string

required

Unique identifier for this revenue signal (prefixed with rev_).

Example:

"rev_288a8a7b4ea68bbfd674b035bde3659b"

signal_date

string<date>

required

The date (YYYY-MM-DD) the underlying observation was published (article or filing date).

Example:

"2025-12-16"

whats_new

string

required

Concise summary of what is new in this signal compared to the previous company context (e.g. "$40M ARR (2024); profitable; ...").

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

enum<string>

required

The kind of source the signal was derived from.

Available options:

news,

social,

public

Example:

"news"

source_url

string

required

URL to the source article or filing.

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

integer

required

Internal article id for the source (only set for news / social).

Example:

496721

entity_id

string

required

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.

Example:

"5e3bbfb900c8f4c966a2d566"

company_name

string

required

Name of the company the signal is attributed to.

Example:

"Ocean Power Technologies"

metric

enum<string>

required

Which revenue metric the value represents.

Available options:

ARR,

Revenue,

GMV

Example:

"Revenue"

annualized_usd

number

required

Annualised revenue in USD at the time of the signal.

Example:

1696000

year

integer

required

The fiscal year the revenue metric refers to.

Example:

2025

reference_date

string<date>

required

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.

Example:

"2025-06-30"

Enrich

Search

Companies

People

Investors

Transactions

Signals

Lists

Saved Searches

Network

Account

Get Revenue Signals for a company list

What you need

Behaviour

What you do next

Authorizations

Path Parameters

Query Parameters

Response