# News

> Recent market headlines WiseView has scored for importance (0-100), newest first.

Source: https://wiseview.ai/docs/api/news

`GET https://api.wiseview.ai/v1/news`

Recent market headlines WiseView has scored for importance (0-100), newest first. Give a symbol for one company's news, or my_watchlist for news on your watchlist names.

Each call counts against your allowance.

## Parameters

| Name | In | Type | What it does |
| --- | --- | --- | --- |
| `symbol` | query | ticker | Stock ticker, like AAPL. |
| `my_watchlist` | query | true or false | Only news on your watchlist names. |
| `min_importance` | query | whole number, 0–100 | Only headlines scored at least this. |
| `limit` | query | whole number, 1–50 | How many headlines. Leave it out for `20`. |

## Answer

`data`, abridged — real answers carry more fields:

```json
{
  "headlines": [
    {
      "headline": "Apple shares rise after record services revenue",
      "publisher": "Example Wire",
      "url": "https://news.example.com/apple-services",
      "symbol": "AAPL",
      "publishedAt": "2026-10-21T13:05:00.000Z",
      "importance": 78,
      "materiality": "material",
      "direction": "bullish",
      "snippet": "Apple reported…"
    }
  ]
}
```

The answer quotes text written outside WiseView and carries a `notice` saying so.

## Samples

```bash
curl "https://api.wiseview.ai/v1/news" \
  -H "Authorization: Bearer $WISEVIEW_API_KEY"
```

```python
import os
import requests

response = requests.get(
    "https://api.wiseview.ai/v1/news",
    headers={"Authorization": f"Bearer {os.environ['WISEVIEW_API_KEY']}"},
)
response.raise_for_status()
print(response.json())
```

```javascript
const response = await fetch("https://api.wiseview.ai/v1/news", {
  headers: { "Authorization": `Bearer ${process.env.WISEVIEW_API_KEY}` },
});
if (!response.ok) throw new Error(`WiseView answered ${response.status}`);
console.log(await response.json());
```
