# News Headlines

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

Returns the latest news headlines for financial markets.

This endpoint provides access to news headlines that may impact the markets, including company-specific
news, sector news, and market-wide events. Headlines can be filtered by source, content, ticker, and significance.

Use the `search_term` parameter to filter by headline content, or the `ticker` parameter to filter
by related ticker symbols. The data includes the headline text, source, related tickers, sentiment,
and whether it's considered a major news item.


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `sources` | News Sources | No | A comma-separated list of news sources to filter by (e.g., 'Reuters,Bloomberg'). |
| `search_term` | News Search Term | No | A search term to filter news headlines by content. |
| `ticker` | News Ticker | No | Filter news headlines to only those mentioning the specified ticker symbol. |
| `major_only` | Major News Only | No | When set to true, only returns major/significant news. |
| `limit` | Default 50 Max 100 Min 1 | No | How many items to return. Default: 50. Max: 100. Min: 1. |
| `page` | Page | No | Page number (use with limit). Starts on page 0. |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `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. |


## Example

### curl

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

### Python

```python
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

```json
{
  "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": []
    }
  ]
}
```