> ## 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 News Signal by ID
> Returns a single news signal by its integer Specter signal ID.
Costs 1 credit per request.
## What you need
A news signal ID (integer); get one from [Get company news](/api-reference/companies/get-company-news) or [Get News Signals for a saved company search](/api-reference/news-signals/get-news-signals-for-a-saved-company-search).
## Behaviour
- `signalId` is an integer and is required.
- Returns `404` if the signal doesn't exist.
## What you do next
- **Open the company.** Follow `entity_id` to [Get company by ID](/api-reference/companies/get-company-by-id).
- **See its full news history.** Get every signal for that company with [Get company news](/api-reference/companies/get-company-news).
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /news-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: 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:
/news-signals/{signalId}:
get:
tags:
- News Signals
summary: Get News Signal by ID
description: >
Returns a single news signal by its integer Specter signal ID.
Costs 1 credit per request.
## What you need
A news signal ID (integer); get one from [Get company
news](/api-reference/companies/get-company-news) or [Get News Signals
for a saved company
search](/api-reference/news-signals/get-news-signals-for-a-saved-company-search).
## Behaviour
- `signalId` is an integer and is required.
- Returns `404` if the signal doesn't exist.
## What you do next
- **Open the company.** Follow `entity_id` to [Get company by
ID](/api-reference/companies/get-company-by-id).
- **See its full news history.** Get every signal for that company with
[Get company news](/api-reference/companies/get-company-news).
parameters:
- $ref: '#/components/parameters/NewsSignalId'
responses:
'200':
$ref: '#/components/responses/NewsSignalResponse'
'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:
NewsSignalId:
in: path
name: signalId
schema:
type: integer
required: true
description: The ID of the news signal being requested.
example: 1234567
responses:
NewsSignalResponse:
description: The requested news signal.
content:
application/json:
schema:
$ref: '#/components/schemas/NewsSignal'
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:
NewsSignal:
title: NewsSignal
type: object
description: >
A single classified company mention within a news article; if an article
mentions multiple companies, each mention is recorded as a separate
signal.
additionalProperties: false
required:
- article_id
- article_url
- categories
- company_domain
- company_name
- entity_id
- featured_image_url
- fetched_at
- meaningful_updates
- published_date
- score
- signal_id
- title
- title_original
- traction
- whats_new
properties:
signal_id:
description: Unique identifier for this news signal.
type: integer
example: 538589
article_id:
description: >-
Underlying article id. Articles that mention multiple companies
share this id across signals.
type: integer
example: 914756
article_url:
description: The URL linking to the original source article.
type: string
example: >-
https://www.linkedin.com/posts/petterblid_so-proud-to-share-our-q2-report-today-and-activity-7481238353364054018-obd_
published_date:
description: Date (YYYY-MM-DD) the article was published.
type: string
format: date
example: '2026-07-10'
fetched_at:
description: Timestamp Specter fetched the article.
type: string
format: date-time
example: '2026-07-10T09:19:40.270718Z'
title:
description: Article title in English (translated when needed).
type: string
example: >-
So proud to share our Q2 report today and the results the team at
Litium has delivered.
title_original:
description: Article title in the original publication language.
type: string
example: >-
So proud to share our Q2 report today and the results the team at
Litium has delivered.
featured_image_url:
description: URL to the article's featured image.
type: string
example: https://www.breakit.se/img/default.png
categories:
description: Categories the publication tagged this article with.
type: array
items:
type: string
example:
- Revenue Update
- Profitability Update
- Growth
entity_id:
description: |
Specter company id that the signal is attributed to.
type: string
example: 5e3bbea200c8f4c9669f6601
company_name:
description: Name of the company the signal is attributed to.
type: string
example: Litium
company_domain:
description: Primary domain of the company.
type: string
example: litium.com
meaningful_updates:
description: >
Categories of newsworthy update detected on the article: revenue
figures, profitability, traction milestones, funding rounds,
acquisitions / deals.
type: array
items:
type: string
enum:
- REVENUE_UPDATE
- PROFIT_UPDATE
- TRACTION_UPDATE
- FUNDING_UPDATE
- DEAL_UPDATE
example:
- REVENUE_UPDATE
- PROFIT_UPDATE
whats_new:
description: >-
A short AI-generated summary of what the article reports for this
company.
type: string
example: >-
Litium ARR SEK 100M (prev ~SEK 90M in 2025); returned to
profitability, Cash EBITDA positive in June.
score:
description: Importance score (0-5). 4+ is considered "major news".
type: integer
example: 4
traction:
description: Free-text traction headline associated with the company, if any.
type: string
example: >-
SEK 100M ARR, Net revenue increased 32%, ARR grew 19%, Returned to
profitability, Cash EBITDA positive in June
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
````