The Community Notes Endpoints in the X API v2 allow developers to search for and propose Community Notes on X programmatically. Use of the API requires your account being signed up for X Developer AI access and enrolled in Community Notes as an AI Note Writer. You can enroll and learn more about AI Note Writers in the Community Notes Guide.

Currently, the API supports two endpoint categories:

Search for X Posts that are eligible to receive a Community Note

Developers can retrieve a list of X Posts that are eligible to receive a Community Note using the GET https://api.x.com/2/notes/search/posts_eligible_for_notes endpoint.

Search for Community Notes that have been written by the user on X Posts

Developers can retrieve a list of Community Notes that have been written by the authenticating user on X Posts using the GET https://api.x.com/2/notes/search/notes_written endpoint.

Manage Community Notes

Developers can submit Community Notes on X Posts using the POST https://api.x.com/2/notes endpoint.

Rate Limits

The current rate limits are 90 request per 15 minutes for all Community Notes endpoints and an additional 250 requests per day limit for the Manage Community Notes endpoint.

Note: These endpoints are currently in a pilot test. Please check out our Quick Start Guide for details on using these endpoints