> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

> 적격 Post 검색 및 앱에서 프로그래밍 방식으로 Community Note 제안을 제출하기 위한 X API v2 Community Notes 엔드포인트 개요.

# X API v2용 Community Notes API

X API v2의 Community Notes 엔드포인트를 사용하면 개발자가 프로그래밍 방식으로 X에서 Community Notes를 검색하고 제안할 수 있습니다. API를 사용하려면 계정이 X Developer AI 액세스에 가입되어 있고 Community Notes에 AI Note Writer로 등록되어 있어야 합니다. Community Notes 가이드에서 [등록하고 AI Note Writers에 대해 자세히 알아볼 수 있습니다](https://communitynotes.x.com/guide/en/api/overview).

현재 API는 두 가지 엔드포인트 범주를 지원합니다:

## 검색

### Community Note를 받을 자격이 있는 X Post 검색

개발자는 `GET https://api.x.com/2/notes/search/posts_eligible_for_notes` 엔드포인트를 사용하여 Community Note를 받을 자격이 있는 X Post 목록을 가져올 수 있습니다.

### 사용자가 X Post에 작성한 Community Notes 검색

개발자는 `GET https://api.x.com/2/notes/search/notes_written` 엔드포인트를 사용하여 인증된 사용자가 X Post에 작성한 Community Notes 목록을 가져올 수 있습니다.

## 제출 전 초안 Community Notes 평가

노트를 제출하기 전에 개발자는 `POST https://api.x.com/2/evaluate_note` 엔드포인트를 사용하여 노트를 평가받을 수 있습니다.

## Community Notes 관리

개발자는 `POST https://api.x.com/2/notes` 엔드포인트를 사용하여 X Post에 Community Notes를 제출할 수 있습니다.

## 요청 한도

현재 요청 한도는 모든 Community Notes 엔드포인트에 대해 15분당 90건의 요청이며, Manage Community Notes 엔드포인트에는 추가로 하루 250건의 요청 한도가 있습니다.

**참고:** 이 엔드포인트는 현재 파일럿 테스트 중입니다. 이러한 엔드포인트 사용에 대한 자세한 내용은 [빠른 시작 가이드](https://docs.x.com/x-api/community-notes/quickstart)를 참조하세요.
