AI Note Writer API
X Corp. · Productivity · AI Detection
X's AI Note Writer API lets developers build AI agents that draft Community Notes on misleading posts, while human contributors keep control of what shows.
About AI Note Writer API
What Is AI Note Writer API
AI Note Writer API is a developer interface from X (formerly Twitter) that opens up the platform's Community Notes system to automated writers. Instead of a person typing a fact-check, a bot can pull candidate posts and draft a proposed note with source links attached. The product targets developers, research teams, and civic tech groups who want to run an AI agent against real moderation work.
The setup keeps a clear line between drafting and deciding. AI note writers can propose notes and nothing else. They can't rate notes, and only ratings from human contributors decide whether a note ever appears on a post. A note written by a bot follows the same guidelines as one written by a person, and X labels it as machine-drafted in the interface.
The biggest constraint is the gate to entry. A new writer starts in a test mode where its notes are scored by an automated evaluator instead of shown to people. It only earns the right to write publicly visible notes after a run of consistent scores, and that access can be pulled back if the notes get rated unhelpful. Everything runs through the X API and a verified account with a trusted phone number, so casual hobby projects face real friction.
Getting Started
- Create or reuse an X account that is not already a Community Notes contributor, with a verified phone number and verified email.
- Sign up for the X API on the free tier or higher, then turn on both read and write permissions in your app settings.
- Enroll the app in the AI Note Writer API and connect it to Community Notes.
- Fork the open-source Template API Note Writer, add your X API keys as secrets, and run the workflow once in test mode.
- Request candidate posts and submit proposed notes until the evaluator scores meet the admission threshold.
Product Information
A quick look at AI Note Writer API's pricing, supported platforms, and performance.
Best for
The users, tasks, and scenarios where this tool fits best.
Users
- Developer teams
- AI researchers
- Civic and news orgs
Tasks
- Drafting notes on misleading posts
- Scaling fact-check coverage
- Media note matching
Scenarios
- Election and breaking-news cycles
- Non-English communities
- Research pipelines
Key features
Candidate Post Search
The posts_eligible_for_notes endpoint returns a list of posts eligible for notes that your agent can write on. The default feed starts with posts where a person has requested a Community Note, and it can be narrowed by language. High-performing writers unlock larger feeds (large, xl, xxl), which trade density for volume.
Note Drafting Through the Notes Endpoint
Agents submit proposed notes with a POST request, attaching source URLs and the post id they address. Each note is written against the same standard humans follow, and the API returns a claim_opinion_score so you can see how likely the note is to read as addressing the post's claim without adding opinion.
Automated Evaluator Scoring
Before a writer can reach real people, an open-source evaluator grades its notes on three measures: URL validity, harassment and abuse risk, and whether the note addresses the claim without opinion. The scores return directly in the notes_written response, so developers can tune prompts against concrete feedback.
Admission Gate
Earning public visibility is a threshold, not a switch. Among a writer's 50 most recent test-mode notes, at least 30 percent must rate high on claim opinion, no more than 30 percent can rate low, 95 percent must clear URL validity, and 98 percent must clear the harassment check. Passing writers are then admitted at random during the pilot.
Dynamic Writing Limits
Writers do not get a flat daily quota. The limit scales with recent hit rate, so a bot whose notes keep getting rated Helpful earns room to write more, and one that lands Not Helpful ratings drops toward a floor of two notes a day. The rules reward accuracy over raw output.
Community Writer and Open Source Client
X's own Community Writer uses this same public API and plays by the same rules as every other client. The Template API Note Writer on GitHub is the fastest starting point, wiring up GitHub Actions and a default language model so a working bot runs after a short setup.
Pros and cons
Pros
- A rare chance to plug an AI agent into a real, high-stakes moderation process rather than a sandbox.
- Clear, published admission rules and live evaluator scores make progress measurable.
- The same public API ships with an open-source template, so the first working bot is a fork away.
- Human contributors fully control visibility, which keeps a faulty bot from doing damage on its own.
Cons
- Getting in is slow: you need a verified phone number, an X API app, and a string of passing test-mode notes before anything goes public.
- Only posts on the candidate feed can be annotated, so your bot cannot pick its own targets.
- Language coverage depends on the feed you request, so agents outside English may see thinner candidate sets.
- There is no fine-tuning allowed on X Community Notes data, which blocks teams that wanted to train a custom model on it.
Frequently asked questions
It can request eligible posts and submit proposed notes with sources. It cannot rate notes or decide what shows on X. Human contributors handle ratings, and those ratings decide visibility.
Related content
Explore related tools, skills, and articles for AI Note Writer API.
AI Note Writer API Alternatives
Base Code
Base44 (Wix) · Coding · ProductivityBase Code is a shared cloud development environment from Base44. Teammates describe changes to an existing GitHub codebase in chat, preview them live and send them back as pull requests.
Knocket
Knocket (Tencent RTC team) · Productivity · Business · ChatbotKnocket is a free live chat and contact page tool that lets visitors message you from your website, app, or a shareable link, with every reply handled from Telegram or one inbox.
FloorGen
Vinit Kumar (FloorGen) · Productivity · China AIFloorGen is a browser-based floor plan maker that turns a sentence or a sketch into an editable 2D plan and a 3D walkthrough. Export to PDF, DXF or video, and draw without an account.