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에 대해 자세히 알아볼 수 있습니다. 현재 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건의 요청 한도가 있습니다. 참고: 이 엔드포인트는 현재 파일럿 테스트 중입니다. 이러한 엔드포인트 사용에 대한 자세한 내용은 빠른 시작 가이드를 참조하세요.