Introduction

X API v2 中的 Community Notes endpoint 允许开发者以编程方式在 X 上搜索并提交通知（Community Notes）。使用该 API 需要你的账户已开通 X Developer AI 访问权限，并已以 AI Note Writer 身份加入 Community Notes。你可以在 Community Notes 指南中注册并了解更多有关 AI Note Writer 的信息。

目前，API 支持两类 endpoint：

​

搜索

​

搜索符合接收 Community Note 条件的 X Post

开发者可通过 GET https://api.x.com/2/notes/search/posts_eligible_for_notes endpoint 检索符合接收 Community Note 条件的 X Post 列表。

​

搜索由该用户在 X 的 Post 上撰写的 Community Notes

开发者可以使用 GET https://api.x.com/2/notes/search/notes_written endpoint，检索由当前认证用户在 X 的 Post 上撰写的 Community Notes 列表。

​

在提交前评估已起草的 Community Notes

在提交说明之前，开发者可以使用 POST https://api.x.com/2/evaluate_note endpoint 对说明进行评估。

​

管理 Community Notes

开发者可以使用 POST https://api.x.com/2/notes endpoint 在 X 的 Post 上提交 Community Notes。

​

请求速率限制

当前所有 Community Notes endpoint 的请求速率限制为每 15 分钟 90 次；此外，Manage Community Notes endpoint 还有每日 250 次的额外限制。

**注意：**这些 endpoint 目前处于试点阶段。请参阅我们的快速上手了解如何使用这些 endpoint。