X community notes API for a writer's deleted notes

{
  "notes": [
    {
      "id": "2078950499982696756",
      "createdAt": "2026-07-19T21:09:58.885Z",
      "ratingStatus": "CurrentlyRatedNotHelpful",
      "notHelpfulTags": [
        "MissingKeyPoints"
      ],
      "decidedBy": "CoreModel (v1.1)"
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "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}

deleted-notes

X community notes API for a writer's deleted notes

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

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/community-notes/contributors/{alias}/deleted-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}/deleted-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>",
      "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
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

List the Community Notes 1 contributor deleted, newest first.

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/deleted-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}/deleted-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,
  created_at: note.createdAt ?? null,
  rating_status: note.ratingStatus ?? null,
  next_cursor: nextCursor,
}));

import requests

alias = "ardent-beach-friarbird"
response = requests.get(
    f"https://xquik.com/api/v1/x/community-notes/contributors/{alias}/deleted-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"],
        "created_at": note.get("createdAt"),
        "rating_status": note.get("ratingStatus"),
        "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.

What does X keep of a deleted note?

X keeps each deleted note’s ID, time, rating status, rater tags & scoring model. It shows a notice in place of the note’s text, so text, classification & post are left out. tombstone holds that notice. A contributor who deleted no note returns an empty list, which is free. Get notes contributor returns the count in deletedNotesCount.

Page through deleted 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.

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 deleted notes, newest first. Note object fields.

string

Note ID.

string

When the contributor wrote the note, as ISO 8601.

string

X’s rating of the note, such as NeedsMoreRatings 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

true for a deleted note.

string

X’s notice in place of the note, such as This note has been deleted.

boolean

Whether the note came through X’s API.

boolean

Whether the note was about a 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 · Contributor notes · Get tweet

{
  "notes": [
    {
      "id": "2078950499982696756",
      "createdAt": "2026-07-19T21:09:58.885Z",
      "ratingStatus": "CurrentlyRatedNotHelpful",
      "notHelpfulTags": [
        "MissingKeyPoints"
      ],
      "decidedBy": "CoreModel (v1.1)"
    }
  ],
  "has_next_page": false,
  "next_cursor": ""
}

{
  "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 writer's deleted notes

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

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/community-notes/contributors/{alias}/deleted-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}/deleted-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>",
      "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
    }
  ],
  "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 writer's deleted notes

What does X keep of a deleted note?

Page through deleted 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

​What does X keep of a deleted note?

​Page through deleted 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

What does X keep of a deleted note?

Page through deleted 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