X community notes API for a contributor's notes

{
  "notes": [
    {
      "id": "2026375778254868976",
      "createdAt": "2026-02-24T19:16:48.435Z",
      "language": "en",
      "classification": "MisinformedOrPotentiallyMisleading",
      "contributor": {
        "alias": "ardent-beach-friarbird",
        "notesCount": {
          "currentlyRatedHelpful": 1,
          "currentlyRatedNotHelpful": 2
        },
        "ratingsCount": {
          "successful": {
            "total": 49
          },
          "unsuccessful": {
            "helpfulCount": 15,
            "notHelpfulCount": 4
          }
        }
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "-1767098234260"
}

{
  "error": "invalid_contributor_alias",
  "message": "Send a Community Notes alias or its x.com/i/communitynotes/u URL."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "contributor_not_found",
  "message": "Contributor not found. Check the alias on its x.com/i/communitynotes/u page."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

community-notes

contributors

{alias}

notes

X community notes API for a contributor's notes

curl --request GET \
  --url https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "notes": [
    {
      "id": "<string>",
      "createdAt": "<string>",
      "language": "<string>",
      "classification": "<string>",
      "text": "<string>",
      "entities": [
        {}
      ],
      "contributor": {},
      "ratingStatus": "<string>",
      "helpfulTags": [
        "<string>"
      ],
      "notHelpfulTags": [
        "<string>"
      ],
      "decidedBy": "<string>",
      "fullyVisibleModel": true,
      "abovePcrhThreshold": true,
      "appealStatus": "<string>",
      "deleted": true,
      "tombstone": "<string>",
      "isApiAuthor": true,
      "isMediaNote": true,
      "mediaNoteMatchCount": 123,
      "isUrlNote": true,
      "displayUrl": "<string>",
      "isTranslatable": true,
      "timeToHelpfulFromNoteMs": 123,
      "timeToHelpfulFromPostMs": 123,
      "impressionCount": 123,
      "postId": "<string>",
      "post": {},
      "postUnavailable": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

List the Community Notes 1 contributor wrote, newest first. Each note comes with the post it is on.

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.

1 credit per note returned · All plans from $0.00012/credit · Supports guest paid reads

curl "https://xquik.com/api/v1/x/community-notes/contributors/ardent-beach-friarbird/notes" \
  -H "x-api-key: xq_your_api_key_here" | jq

const alias = "ardent-beach-friarbird";
const url = `https://xquik.com/api/v1/x/community-notes/contributors/${alias}/notes`;
const response = await fetch(url, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
if (!response.ok) throw new Error(JSON.stringify(data));

const nextCursor = data.has_next_page ? data.next_cursor : null;
const noteRows = data.notes.map((note) => ({
  contributor_alias: alias,
  note_id: note.id,
  rating_status: note.ratingStatus ?? null,
  text: note.text ?? null,
  post_id: note.postId ?? null,
  post_author: note.post?.author?.username ?? null,
  next_cursor: nextCursor,
}));

import requests

alias = "ardent-beach-friarbird"
response = requests.get(
    f"https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes",
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
if not response.ok:
    raise RuntimeError(data)

next_cursor = data["next_cursor"] if data["has_next_page"] else None
note_rows = [
    {
        "contributor_alias": alias,
        "note_id": note["id"],
        "rating_status": note.get("ratingStatus"),
        "text": note.get("text"),
        "post_id": note.get("postId"),
        "post_author": ((note.get("post") or {}).get("author") or {}).get("username"),
        "next_cursor": next_cursor,
    }
    for note in data["notes"]
]

The Node.js and Python snippets build 1 row per note. Store the rows with the cursor before you request the next page.

Which notes does it return?

It returns every note the contributor wrote, whatever its rating. Only helpful notes show under posts on x.com, so this list also holds the notes x.com hides.

ratingStatus says how X rates the note now, such as NeedsMoreRatings or CurrentlyRatedHelpful.
helpfulTags & notHelpfulTags say why raters called it helpful or not.
timeToHelpfulFromNoteMs says how long the note took to be rated helpful.
post is the post the note is on, with the same fields as Get tweet.

For a post X no longer shows, post is null. postId still names it, and postUnavailable.reason says why when X gives a reason, such as Suspended.

Page through a contributor’s notes

Each page returns has_next_page and next_cursor. Send next_cursor back as cursor. Stop when has_next_page is false. A cursor X never issued returns 400 invalid_cursor, which is free. Start again without cursor, then use next_cursor. Use the note id as the key in your store. Overlapping reads then add no duplicates.

Path parameters

string

required

Contributor alias, such as ardent-beach-friarbird. The URL-encoded contributor URL also works, such as x.com/i/communitynotes/u/ardent-beach-friarbird. Any letter case works.

Query parameters

string

Pagination cursor from a previous response. Omit for the first page.

integer

Notes per page, from 1 to 10. Defaults to 10. Also read as limit, count, max_results, maxItems, max_items & per_page.

Choose fields

string

Fields to keep in each row, comma-separated, such as id,text,author.username. Use dots for nested fields. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name returns 400 unknown_field with the valid names, before any read. The price stays the same.

string

Fields to drop from each row, comma-separated, such as entities,media. It takes the same names as fields. With fields, it drops from the kept fields.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

X leaves out a field that a note lacks. Only id is always present.

object[]

The contributor’s notes, newest first. Note object fields.

string

Note ID.

string

When the contributor wrote the note, as ISO 8601.

string

Language code of the note.

string

What the writer says of the post, such as MisinformedOrPotentiallyMisleading or NotMisleading.

string

What the note says.

object[]

Links, tags & accounts inside the text, each with fromIndex, toIndex & ref.

object

The note’s writer, with the counts X sends beside a note. Get notes contributor returns every count.

string

X’s current rating, such as NeedsMoreRatings, CurrentlyRatedHelpful or CurrentlyRatedNotHelpful.

string[]

Why raters called the note helpful.

string[]

Why raters called the note not helpful.

string

The X scoring model that set the rating.

boolean

Whether X marks that scoring model as fully visible.

boolean

Whether the note scores above X’s bar for a possible helpful rating.

string

Whether the rating is under appeal.

boolean

Whether the writer deleted the note.

string

X’s notice in place of a deleted note.

boolean

Whether the note came through X’s API.

boolean

Whether the note is about the post’s media.

number

400 Invalid alias or cursor

{
  "error": "invalid_contributor_alias",
  "message": "Send a Community Notes alias or its x.com/i/communitynotes/u URL."
}

A cursor X never issued returns invalid_cursor. Start again without cursor. Both answers are free.

404 Contributor not found

{
  "error": "contributor_not_found",
  "message": "Contributor not found. Check the alias on its x.com/i/communitynotes/u page."
}

No contributor holds the alias. This answer is free.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

{ "error": "unauthenticated" }

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Related. Get notes contributor · Deleted notes · Get tweet

{
  "notes": [
    {
      "id": "2026375778254868976",
      "createdAt": "2026-02-24T19:16:48.435Z",
      "language": "en",
      "classification": "MisinformedOrPotentiallyMisleading",
      "contributor": {
        "alias": "ardent-beach-friarbird",
        "notesCount": {
          "currentlyRatedHelpful": 1,
          "currentlyRatedNotHelpful": 2
        },
        "ratingsCount": {
          "successful": {
            "total": 49
          },
          "unsuccessful": {
            "helpfulCount": 15,
            "notHelpfulCount": 4
          }
        }
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "-1767098234260"
}

{
  "error": "invalid_contributor_alias",
  "message": "Send a Community Notes alias or its x.com/i/communitynotes/u URL."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "contributor_not_found",
  "message": "Contributor not found. Check the alias on its x.com/i/communitynotes/u page."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

X community notes API for a contributor's notes

curl --request GET \
  --url https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "notes": [
    {
      "id": "<string>",
      "createdAt": "<string>",
      "language": "<string>",
      "classification": "<string>",
      "text": "<string>",
      "entities": [
        {}
      ],
      "contributor": {},
      "ratingStatus": "<string>",
      "helpfulTags": [
        "<string>"
      ],
      "notHelpfulTags": [
        "<string>"
      ],
      "decidedBy": "<string>",
      "fullyVisibleModel": true,
      "abovePcrhThreshold": true,
      "appealStatus": "<string>",
      "deleted": true,
      "tombstone": "<string>",
      "isApiAuthor": true,
      "isMediaNote": true,
      "mediaNoteMatchCount": 123,
      "isUrlNote": true,
      "displayUrl": "<string>",
      "isTranslatable": true,
      "timeToHelpfulFromNoteMs": 123,
      "timeToHelpfulFromPostMs": 123,
      "impressionCount": 123,
      "postId": "<string>",
      "post": {},
      "postUnavailable": {}
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

X community notes API for a contributor's notes

Which notes does it return?

Page through a contributor’s notes

Path parameters

Query parameters

Choose fields

Headers

Response

200 OK

400 Invalid alias or cursor

404 Contributor not found

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed

​Which notes does it return?

​Page through a contributor’s notes

​Path parameters

​Query parameters

​Choose fields

​Headers

​Response

​200 OK

​400 Invalid alias or cursor

​404 Contributor not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

Which notes does it return?

Page through a contributor’s notes

Path parameters

Query parameters

Choose fields

Headers

Response

200 OK

400 Invalid alias or cursor

404 Contributor not found

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed