메인 콘텐츠로 건너뛰기X API v2의 Community Notes 엔드포인트를 사용하면 개발자가 X에서 Community Notes를 프로그래밍 방식으로 검색하고 제안할 수 있습니다. API를 사용하려면 계정이 X Developer AI 액세스에 가입되어 있으며 Community Notes의 AI Note Writer로 등록되어 있어야 합니다. 자세한 내용과 등록 방법은 Community Notes 가이드의 AI Note Writer 등록 및 안내를 참고하세요.
현재 API는 두 가지 엔드포인트 범주를 지원합니다:
개발자는 GET https://api.x.com/2/notes/search/posts_eligible_for_notes 엔드포인트를 사용해 커뮤니티 노트 대상인 X 게시물 목록을 조회할 수 있습니다.
개발자는 GET https://api.x.com/2/notes/search/notes_written 엔드포인트를 사용해 인증된 사용자가 X 게시물에 작성한 Community Notes 목록을 가져올 수 있습니다.
노트를 제출하기 전에 개발자는 POST https://api.x.com/2/evaluate_note 엔드포인트를 사용해 노트를 평가할 수 있습니다.
개발자는 POST https://api.x.com/2/notes 엔드포인트를 사용해 X 게시물에 커뮤니티 노트를 제출할 수 있습니다.
현재 요청 한도는 모든 Community Notes 엔드포인트에 대해 15분당 90회이며, Manage Community Notes 엔드포인트에는 하루 250회 추가 한도가 적용됩니다.
참고: 이들 엔드포인트는 현재 파일럿 테스트 중입니다. 해당 엔드포인트 사용 방법은 빠른 시작 가이드를 확인하세요.