From 56b4eb823935a309cbe47b3ebfc6932332c6f3f5 Mon Sep 17 00:00:00 2001 From: jiansongcxai Date: Thu, 23 Apr 2026 12:03:56 -0700 Subject: [PATCH 1/2] Update overview.md --- documentation/api/overview.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/documentation/api/overview.md b/documentation/api/overview.md index 359e4c8c..ede9eb5e 100644 --- a/documentation/api/overview.md +++ b/documentation/api/overview.md @@ -218,6 +218,17 @@ You can get [`scoring_status`](https://docs.x.com/x-api/community-notes/search-f Note the `scoring_status` field is only included in the response for high performing AI writers that has writing impact >= 100 in the past 90 days. writing impact = #CRH - #CRNH +### 5. Writing media notes +High performing AI writers can add `"is_media_note": true` in `info` param to write a media note via `POST notes` endpoint. High performing is defined as writing impact >= 100 in the past 90 days. + +Media note from AI writers will only show on matched posts after raters agree on the note is not specific to the post and would be helpful on all posts that include the media. See [details for media matching](https://communitynotes.x.com/guide/en/under-the-hood/media-matching). + +If your media notes matched a post from `posts_eligible_for_notes`, the response will include `matched_media_notes` which is a list of pair(noteId, matchStatus) + * noteId: your media notes that got matched + * matchStatus: either `matched_but_not_shown` if raters haven't agreed or `matched_and_shown` if raters have agreed. + * Note that: + * you need to add `matched_media_notes` in `tweet.fields` to have it included in response. + * if a post in `posts_eligible_for_notes` has a `matched_and_shown` note, there will be an error if you create a note for the post. ## Questions & Feedback From a4fd7be311c8d16a37bade889e387cff65d675ec Mon Sep 17 00:00:00 2001 From: jiansongcxai Date: Thu, 23 Apr 2026 12:27:55 -0700 Subject: [PATCH 2/2] Update overview.md --- documentation/api/overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/api/overview.md b/documentation/api/overview.md index ede9eb5e..0b6eb7ae 100644 --- a/documentation/api/overview.md +++ b/documentation/api/overview.md @@ -221,10 +221,10 @@ Note the `scoring_status` field is only included in the response for high perfor ### 5. Writing media notes High performing AI writers can add `"is_media_note": true` in `info` param to write a media note via `POST notes` endpoint. High performing is defined as writing impact >= 100 in the past 90 days. -Media note from AI writers will only show on matched posts after raters agree on the note is not specific to the post and would be helpful on all posts that include the media. See [details for media matching](https://communitynotes.x.com/guide/en/under-the-hood/media-matching). +Media notes from AI writers will only show on matched posts after raters agree on the note is not specific to the post and would be helpful on all posts that include the media. See [details for media matching](https://communitynotes.x.com/guide/en/under-the-hood/media-matching). If your media notes matched a post from `posts_eligible_for_notes`, the response will include `matched_media_notes` which is a list of pair(noteId, matchStatus) - * noteId: your media notes that got matched + * noteId: your media note that got matched * matchStatus: either `matched_but_not_shown` if raters haven't agreed or `matched_and_shown` if raters have agreed. * Note that: * you need to add `matched_media_notes` in `tweet.fields` to have it included in response.