Historical Asset-Specific Headlines

get

https://dev-copilot-api.permutable.ai/v1/headlines/feed/historical/ticker/{ticker}

Retrieves a list of the historical news headlines for a specific financial ticker. Supports filtering by news sources and languages.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

ticker

string

required

Ticker of the asset. Get these from GET /ticker endpoints.

Query Params

topic_preset

string

Defaults to ALL

Topic preset to filter by. Can be preset or individual topic name. Use GET /headlines/topics/ticker/presets to get the available presets and /headlines/topics/ticker to get the available topics.

topic_probability_threshold

number

Defaults to 0.1

Threshold for topic probability to filter by (greater than or equal to). Must be between 0 and 1.

abs_sentiment_threshold

number

Defaults to 0.1

Threshold for absolute sentiment to filter by (greater than or equal to). Must be between 0 and 1.

end_date

limit

integer

1 to 1000

Defaults to 100

Number of records per page

source_preset

string

Defaults to ALL

Source preset to filter by. Available presets: ALL, FINANCIAL. Defaults to 'ALL'. Get individual source names from GET /sources and presets from GET /sources/presets

language_preset

string

Defaults to ALL

Language preset to filter by. Available presets: ALL, ENGLISH, EUROPEAN, EUROPEAN_MAJOR, ASIAN, EAST_ASIAN, SOUTH_ASIAN, SOUTHEAST_ASIAN, MIDDLE_EASTERN, AFRICAN, LATIN_AMERICAN. Defaults to 'ALL'. Get individual language codes from GET /languages and presets from GET /languages/presets

match_type

string

Defaults to COMBINED

How the asset is found to be relevant to the headline. Explicit means the asset is explicitly mentioned in the headline, Implicit means the asset is implied or inferred from the headline. Options are COMBINED, EXPLICIT, IMPLICIT

source_country_preset

string

Defaults to ALL

Source country preset or individual country name to filter by. Available presets: ALL, G7, EUROPE, ASIA, EAST_ASIA, SOUTH_ASIA, SOUTHEAST_ASIA, AMERICAS, AFRICA, DEVELOPED, DEVELOPING. Defaults to 'ALL'. Get individual country names from GET /countries and presets from GET /countries/presets

start_date

Start date for the time range filter (YYYY-MM-DD format). If not provided, defaults to 7 days ago.

next_token

Pagination cursor from previous response. Use this to continue pagination within the same time range.

Responses

200Successfully retrieved headlines

400Length of ticker must be between 1 and 100

403User does not have permission to read headlines

404No headlines found for the given asset

429Too Many Requests — rate limit exceeded; slow down and retry

500Internal server error