ai-news-feed

# AI News Feed API

Query pre-aggregated, LLM-enriched AI/ML news from 57+ Twitter/X accounts. Data is updated every 2 hours.

## API Access & Setup

**Before making any API call**, check if the user has a RapidAPI key configured. If not, guide them through these steps:

1. **Sign up / Log in** at <https://rapidapi.com> (free)
2. **Subscribe** to the API at <https://rapidapi.com/jiachenfred/api/twitter-ai-news-feed> (free tier available, no credit card needed)
3. After subscribing, go to the API's **Endpoints** tab on RapidAPI — the `X-RapidAPI-Key` will be auto-filled in the code snippets on the right side. Copy it.
4. Store the key for future use (e.g. in an environment variable `RAPIDAPI_KEY`)

**All requests must include these headers:**
```
X-RapidAPI-Key: <user's own key from step 3>
X-RapidAPI-Host: twitter-ai-news-feed.p.rapidapi.com
```

**Base URL**: `https://twitter-ai-news-feed.p.rapidapi.com`

**Response format**: All endpoints return JSON. See [references/api-spec.md](references/api-spec.md) for full response schemas.

## Endpoints

### Get Feed — `GET /v1/feed`

Latest posts sorted by recency.

| Param | Type | Default | Description |
|---|---|---|---|
| `lang` | `en` \| `zh` | `en` | Response language |
| `limit` | 1-100 | 20 | Number of posts |
| `offset` | int | 0 | Pagination |
| `tags` | string | — | Comma-separated filter: `paper`, `model_release`, `funding`, `product_launch`, `opinion`, `tutorial`, `benchmark`, `open_source`, `regulation`, `industry` |
| `min_importance` | 1-10 | — | Minimum importance score |
| `since` | unix ts | — | Posts after this timestamp |

Example: `GET /v1/feed?lang=zh&limit=5&tags=model_release,paper&min_importance=7`

### Get Trending — `GET /v1/feed/trending`

Top posts ranked by importance within a time window.

| Param | Type | Default | Description |
|---|---|---|---|
| `lang` | `en` \| `zh` | `en` | Response language |
| `limit` | 1-50 | 10 | Number of posts |
| `hours` | 1-168 | 24 | Time window (168 = 7 days)...