News Headlines

GET https://api.unusualwhales.com/api/news/headlines

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

sources News Sources optional

A comma-separated list of news sources to filter by (e.g., 'Reuters,Bloomberg').

Example: BusinessWire,MarketNews

search_term News Search Term optional

A search term to filter news headlines by content.

Example: earnings

ticker News Ticker optional

Filter news headlines to only those mentioning the specified ticker symbol.

Example: AAPL

major_only Major News Only optional

When set to true, only returns major/significant news.

Example: true

limit Default 50 Max 100 Min 1 optional

How many items to return. Default: 50. Max: 100. Min: 1.

Example: 10 Default: 50

>= 1 <= 100

page Page optional

Page number (use with limit). Starts on page 0.

Example: 1

Responses

200 422 500

Response Body 200 OK

created_at string

Timestamp when the news headline was created or published.

headline string

The actual news headline text.

is_major boolean

Indicates whether the news is considered major or significant.

meta object

Additional metadata related to the headline.

sentiment string

Sentiment analysis of the headline (e.g., positive, negative, neutral).

source string

Source of the news headline (e.g., Reuters, Bloomberg, etc.).

tags array[string]

Tags or categories related to the headline.

tickers array[string]

List of ticker symbols related to this news.

Try It GET

API Token

Query Parameters

sources News Sources

search_term News Search Term

ticker News Ticker

major_only Major News Only

limit Default 50 Max 100 Min 1

page Page

Request Sample

curl -X GET "https://api.unusualwhales.com/api/news/headlines" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/news/headlines", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "created_at": "2023-04-15T16:30:00Z",
      "headline": "Company XYZ Reports Better Than Expected Earnings",
      "is_major": true,
      "meta": {},
      "sentiment": "positive",
      "source": "BusinessWire",
      "tags": [
        "earnings",
        "tech"
      ],
      "tickers": [
        "XYZ",
        "EXMP"
      ]
    },
    {
      "created_at": "2023-04-15T14:20:00Z",
      "headline": "Federal Reserve Signals Possible Rate Cut",
      "is_major": true,
      "meta": {},
      "sentiment": "neutral",
      "source": "MarketNews",
      "tags": [
        "federal-reserve",
        "interest-rates"
      ],
      "tickers": []
    }
  ]
}