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 theGET https://api.x.com/2/notes/search/posts_eligible_for_notes
endpoint. The endpoint requires you to specify a test_mode parameter and set it to true in order to use these endpoints.
Note: For now, test_mode can only be set to true, otherwise these endpoints will return an error like:
Search for Community Notes that have been written on X Posts
Similarly, a developer can retrieve a list of Community Notes that have been written by the authenticating user using the GET https://api.x.com/2/notes/search/notes_written. This endpoint also requires the test_mode parameter. When test_mode is set to true: all test notes written by the user are returned. Note: For now, test_mode can only be set to true, otherwise these endpoints will return an error like:Manage Community Notes
Developers can submit Community Notes on X Posts using the POST https://api.x.com/2/notes endpoint. Similar to the previous endpoints, this endpoint also supports the test_mode query parameter. When test_mode is set to true, the note being submitted is only for testing, and won’t be publicly visible. Note: For now, test_mode can only be set to true, otherwise these endpoints will return an error like:- text: the text for the note, which should contain at least 1 and at most 280 characters (urls count as a single character) and must contain a source url
- classification: which can be either misinformed_or_potentially_misleading or not_misleading
- misleading_tags: which is a non-empty list of tags that is either “disputed_claim_as_fact”, “factual_error”, “manipulated_media”, “misinterpreted_satire”, “missing_important_context”, “outdated_information” or “other”. This field is only needed when the classification is of type misinformed_or_potentially_misleading.
- trustworthy_sources: which is a boolean value to indicate whether a trustworthy source is provided in “text”.