> For the complete documentation index, see [llms.txt](https://docs.alpha-lenz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alpha-lenz.com/en/api-reference/public-api/news.md).

# News

Access news articles and market updates.

**Required Scope:** `read:news` or `read:all`

## List News Articles

Get news articles with optional filtering.

```
GET /api/public/v1/news/articles
```

### Query Parameters

| Parameter  | Type    | Description                                  |
| ---------- | ------- | -------------------------------------------- |
| `skip`     | integer | Items to skip (default: 0)                   |
| `limit`    | integer | Max items to return (1-100, default: 50)     |
| `category` | string  | Filter by category                           |
| `priority` | integer | Filter by priority (1=high, 2=medium, 3=low) |

### Headers

| Header     | Description                                 |
| ---------- | ------------------------------------------- |
| `x-locale` | Language code: ko, en, ja, zh (default: en) |

### Example Request

```bash
curl -X GET "https://api.alpha-lenz.com/api/public/v1/news/articles?limit=20&category=market_move" \
     -H "X-API-Key: ak_your_key" \
     -H "x-locale: ko"
```

### Response

```json
{
  "articles": [
    {
      "id": 123,
      "title": "Major Market Movement: Tech Stocks Rally",
      "summary": "Technology stocks led the market rally today...",
      "category": "market_move",
      "priority": 1,
      "source_url": "https://example.com/article",
      "published_at": "2024-01-15T14:30:00Z",
      "created_at": "2024-01-15T14:35:00Z"
    }
  ],
  "total": 150,
  "skip": 0,
  "limit": 20
}
```

***

## Get News Article

Get detailed information about a specific news article.

```
GET /api/public/v1/news/articles/{article_id}
```

### Path Parameters

| Parameter    | Type    | Description     |
| ------------ | ------- | --------------- |
| `article_id` | integer | News article ID |

### Example Request

```bash
curl -X GET "https://api.alpha-lenz.com/api/public/v1/news/articles/123" \
     -H "X-API-Key: ak_your_key" \
     -H "x-locale: en"
```

### Response

```json
{
  "id": 123,
  "title": "Major Market Movement: Tech Stocks Rally",
  "summary": "Technology stocks led the market rally today...",
  "ai_angle": "AI analysis perspective on the market movement...",
  "risk": "Key risks to watch...",
  "category": "market_move",
  "priority": 1,
  "source_url": "https://example.com/article",
  "trigger": [
    {
      "topic": "Tech Stocks",
      "sentiment": "positive"
    }
  ],
  "published_at": "2024-01-15T14:30:00Z",
  "created_at": "2024-01-15T14:35:00Z"
}
```

***

## Get Article Full Content

Get the full content of a news article.

```
GET /api/public/v1/news/articles/{article_id}/content
```

### Path Parameters

| Parameter    | Type    | Description     |
| ------------ | ------- | --------------- |
| `article_id` | integer | News article ID |

### Example Request

```bash
curl -X GET "https://api.alpha-lenz.com/api/public/v1/news/articles/123/content" \
     -H "X-API-Key: ak_your_key" \
     -H "x-locale: ko"
```

### Response

```json
{
  "id": 123,
  "title": "Major Market Movement: Tech Stocks Rally",
  "content_type": "html",
  "full_content": "<div>Full article content here...</div>"
}
```

### Categories

Available news categories:

| Category      | Description                    |
| ------------- | ------------------------------ |
| `eod_summary` | End of day market summary      |
| `fed_policy`  | Federal Reserve policy updates |
| `market_move` | Significant market movements   |
| `earnings`    | Earnings reports               |
| `breaking`    | Breaking news                  |

### Language Support

Use the `x-locale` header to get localized content:

* `ko` - Korean
* `en` - English (default)
* `ja` - Japanese
* `zh` - Chinese