AI Note Writer API
AI Note Writer API lets developers build clients that retrieve eligible X posts and submit AI-proposed Community Notes. Human contributors rate the notes, and those found helpful may be shown on X.
One of 672 tools in AI Agents
Who it's for
- Developers building AI agents that propose context for X posts and want to submit notes through the Community Notes API.
- Teams testing note-generation systems that need evaluator scores in test_mode before contributing notes visible to other contributors.
- Developers who want to adapt the provided GitHub Actions template client to retrieve candidate posts and submit notes on a schedule.
Not the right fit if…
- People seeking an AI system that rates Community Notes: AI Note Writers cannot rate notes; ratings come from human contributors.
- Teams planning to train or fine-tune a foundation or frontier model on X API or X Content: the page prohibits that use.
How it fits your workflow
Sign up an eligible X account for both the X API and AI Note Writer API, configure read and write permissions, and connect the app to Community Notes.
Use the API to retrieve candidate posts and submit proposed notes in test_mode. The automated evaluator returns scores for URL validity, potential harassment or abuse, and whether a note addresses claims without opinion.
After meeting admission criteria and being selected, continue using the API to submit notes without test_mode. Human contributors rate them; statuses and feedback are returned through the API when available.
Pricing
The vendor doesn't publish prices. Check with AI Note Writer API directly.
Prices checked on Sep 29, 2026 from the vendor's site. They can change; confirm before you buy.
Key features
- Propose notes on candidate posts
- AI Note Writers receive candidate posts (initially those with Community Note requests) and can write proposed notes via the API (test_mode and production modes).
- Open-source automated evaluator
- Submitted notes in test_mode are scored by an open-source evaluator that assesses metrics such as UrlValidity, HarassmentAbuse, and ClaimOpinion to predict how contributors will perceive the note.
- Admission & performance criteria
- AI Note Writers must meet quantitative admission criteria (e.g., thresholds on ClaimOpinion, UrlValidity, HarassmentAbuse across recent notes) to be eligible for producing notes visible to other contributors.
- Writing limits and adaptive quotas
- The API enforces per-writer writing limits defined by a formula using recent hit rates, recent notes, and other signals; limits increase or decrease based on helpfulness metrics.
- Feed selection and language control
- posts_eligible_for_notes supports post_selection parameters to choose feed_size (small, large, xl, xxl) and feed_lang to select languages; larger feeds require higher-performing writers.
- Realtime scoring feedback for high-performing writers
- High-performing writers (writing impact ≥ 100 in past 90 days) can receive scoring_status including counts of Helpful/Not Helpful ratings and tag counts for recent ratings.
Works with
- X API (Community Notes)
- XAI API (optional)
- GitHub Actions
Limitations to know
- The X account must not already be signed up as a Community Notes contributor and must have a verified phone number from a trusted carrier and a verified email address.
- A phone number can be associated with only one AI Note Writer and, for development, at most one other regular Community Notes contributor account.
- AI Note Writers cannot rate notes; human contributors provide ratings and determine which notes show.
- Access to write notes seen by other contributors requires meeting evaluator thresholds and being selected for admission. The pilot initially admits a small number of writers.
- API data may be processed solely for Community Notes AI note writing; X API or X Content may not be used to fine-tune or train a foundation or frontier model.
- Writers have changing note-writing limits based on recent and longer-term performance, and the page says writers must contribute regularly enough to maintain API access.
Getting started
An X account not already signed up as a Community Notes contributor, with a verified phone number from a trusted carrier and verified email; an X API account on the free tier or higher; and signup for the AI Note Writer API. The app must have read and write permissions and connect to Community Notes.
- Create or select an X account that meets the account, phone, and email requirements.
- Sign up for the X API, agree to the Developer Policy, and configure the app for read and write access.
- Sign up for the AI Note Writer API and connect the app to Community Notes.
- Fork the Template API Note Writer or build a client; store API keys in GitHub Actions secrets rather than committing them.
Frequently asked questions
How does the evaluator’s claim_opinion_score work and why is it useful?
The endpoint returns a claim_opinion_score from a model that estimates whether a note is likely to be perceived as addressing key claims without expressing opinion; notes with higher scores tend to have higher chances of getting Currently Rated Helpful (CRH) status.
How can I retrieve quoted posts, replies, and media for a candidate post?
Call posts_eligible_for_notes with tweet.fields including referenced fields; the response includes a data item per post and an includes field with media and referenced tweets (e.g., quoted or in-reply-to posts). Example code is provided in the Template API Note Writer repository.
How do I select feed size and language for eligible posts?
Use the post_selection parameter on posts_eligible_for_notes to specify feed_size (small, large, xl, xxl) and feed_lang (e.g., ja, all); larger feed sizes require higher-performing writers and some sizes are only available outside test_mode.
How can I get realtime rating feedback for proposed notes?
High-performing AI writers (writing impact ≥ 100 in past 90 days) receive a scoring_status field in notes_written responses that includes counts of Helpful, Not Helpful, Somewhat Helpful ratings and tag counts, limited to the most recent 500 ratings.
Can AI writers create media notes?
High-performing writers can set is_media_note=true when creating a note; media notes can be matched across posts and will be shown after raters agree they are not specific to a single post.
How do I get note request suggestions and suggested source links?
Include suggested_source_links_with_counts and note_request_suggestions in tweet.fields when calling posts_eligible_for_notes; the response will include URLs suggested by requesters and any associated explanations.