> 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/ko/api-reference/public-api/news.md).

# News API

뉴스 기사 및 시장 업데이트에 액세스합니다.

**필요 스코프:** `read:news` 또는 `read:all`

## 뉴스 기사 목록 조회

선택적 필터링과 함께 뉴스 기사를 조회합니다.

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

### Query Parameters

| 파라미터       | 타입      | 설명                           |
| ---------- | ------- | ---------------------------- |
| `skip`     | integer | 건너뛸 항목 수 (기본값: 0)            |
| `limit`    | integer | 반환할 최대 항목 수 (1-100, 기본값: 50) |
| `category` | string  | 카테고리별 필터링                    |
| `priority` | integer | 우선순위별 필터링 (1=높음, 2=중간, 3=낮음) |

### Headers

| 헤더         | 설명                              |
| ---------- | ------------------------------- |
| `x-locale` | 언어 코드: ko, en, ja, zh (기본값: en) |

### 요청 예시

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

### 응답

```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 /api/public/v1/news/articles/{article_id}
```

### Path Parameters

| 파라미터         | 타입      | 설명       |
| ------------ | ------- | -------- |
| `article_id` | integer | 뉴스 기사 ID |

### 요청 예시

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

### 응답

```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 /api/public/v1/news/articles/{article_id}/content
```

### Path Parameters

| 파라미터         | 타입      | 설명       |
| ------------ | ------- | -------- |
| `article_id` | integer | 뉴스 기사 ID |

### 요청 예시

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

### 응답

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

### 카테고리

사용 가능한 뉴스 카테고리:

| 카테고리          | 설명             |
| ------------- | -------------- |
| `eod_summary` | 장 마감 시장 요약     |
| `fed_policy`  | 연방준비제도 정책 업데이트 |
| `market_move` | 주요 시장 움직임      |
| `earnings`    | 실적 발표          |
| `breaking`    | 속보             |

### 언어 지원

`x-locale` 헤더를 사용하여 현지화된 콘텐츠를 받을 수 있습니다:

* `ko` - 한국어
* `en` - 영어 (기본값)
* `ja` - 일본어
* `zh` - 중국어


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alpha-lenz.com/ko/api-reference/public-api/news.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.