---
title: "Read stored news articles"
canonical_url: "https://tweetstream.io/docs/api/get-news-history"
last_updated: 2026-11-05
---

# Read stored news articles

GET /api/news/history returns stored articles from your enabled news sources, newest first, up to 100 per page. Page back with the cursor in nextCursor.

Canonical URL: https://tweetstream.io/docs/api/get-news-history

## `GET /api/news/history`

`https://api.tweetstream.io/api/news/history`

## Authorization

| Name | Type | Description |
| --- | --- | --- |
| `Authorization` | `string`, required | Bearer authentication with your TweetStream API key: `Bearer <key>`. |

## Query parameters

| Name | Type | Description |
| --- | --- | --- |
| `before` | `string` | Cursor from the prior response, or an ISO date. |
| `sourceId` | `string` |  |
| `limit` | `integer` |  |

## Response fields

| Name | Type | Description |
| --- | --- | --- |
| `data` | `object[]`, required |  |
| `data.author` | `string \| null`, required |  |
| `data.categories` | `string[]`, required |  |
| `data.content` | `string \| null`, required |  |
| `data.copyright` | `string \| null`, required |  |
| `data.description` | `string \| null`, required |  |
| `data.id` | `string`, required |  |
| `data.keywords` | `string[]`, required |  |
| `data.language` | `string \| null`, required |  |
| `data.media` | `object[]`, required |  |
| `data.modifiedAt` | `string \| null`, required |  |
| `data.primaryCategory` | `string \| null`, required |  |
| `data.publishedAt` | `string`, required |  |
| `data.receivedAt` | `string`, required |  |
| `data.source` | `object`, required |  |
| `data.source.id` | `string`, required |  |
| `data.source.name` | `string`, required |  |
| `data.summary` | `string \| null`, required |  |
| `data.title` | `string`, required |  |
| `data.url` | `string`, required |  |
| `metadata` | `object`, required |  |
| `metadata.count` | `integer`, required |  |
| `metadata.nextCursor` | `string \| null`, required |  |
| `metadata.sourceId` | `string` |  |

## Responses

| Status | Description | Headers |
| --- | --- | --- |
| `200` | Success |  |
| `400` | Invalid request |  |
| `401` | Missing or invalid API key |  |
| `403` | The authenticated account cannot use this capability |  |
| `429` | Rate limit reached |  |
| `500` | The request could not be completed |  |

### 200

```json
{
  "data": [
    {
      "id": "news_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "source": {
        "id": "bbc-news",
        "name": "BBC News"
      },
      "url": "https://www.bbc.com/news/articles/example",
      "title": "Markets open after the holiday",
      "publishedAt": "2026-08-26T23:27:38.000Z",
      "receivedAt": "2026-08-26T23:27:38.123Z",
      "modifiedAt": null,
      "primaryCategory": "Business",
      "categories": [
        "Business"
      ],
      "author": "BBC News",
      "keywords": [
        "markets"
      ],
      "description": "A brief description supplied by the publication.",
      "summary": "Markets reopened after the holiday.",
      "media": [
        {
          "url": "https://ichef.bbci.co.uk/news/example.jpg",
          "type": "image",
          "caption": "A market floor"
        }
      ],
      "content": "The stored article text, when available.",
      "language": "en",
      "copyright": "BBC"
    }
  ],
  "metadata": {
    "count": 1,
    "nextCursor": "v1.MTc4Nzc4Njg1ODEyMwpuZXdzXzAxMjM0NTY3ODlhYmNkZWYwMTIzNDU2Nzg5YWJjZGVmMDEyMzQ1Njc4OWFiY2RlZjAxMjM0NTY3ODlhYmNkZWY",
    "sourceId": "bbc-news"
  }
}
```

### 400

```json
{
  "error": "<string>"
}
```

### 401

```json
{
  "error": "<string>"
}
```

### 403

```json
{
  "error": "<string>"
}
```

### 429

```json
{
  "error": "<string>",
  "retryAfterSeconds": 0
}
```

### 500

```json
{
  "error": "<string>"
}
```

## Code samples

### cURL

```bash
curl --request GET \
  --url https://api.tweetstream.io/api/news/history \
  --header "Authorization: Bearer $TWEETSTREAM_API_KEY"
```

### JavaScript

```javascript
const response = await fetch("https://api.tweetstream.io/api/news/history", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.TWEETSTREAM_API_KEY}`,
  },
});

console.log(response.status, await response.json());
```

### Python

```python
import os
import requests

response = requests.get(
    "https://api.tweetstream.io/api/news/history",
    headers={"Authorization": f"Bearer {os.environ['TWEETSTREAM_API_KEY']}"},
)

print(response.status_code, response.json())
```
