Skip to main content
GET https://xquik.com/api/v1/x/community-notes/contributors/{alias}/notes 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
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. It has the same fields as Get tweet.
For a post X no longer shows, post is null. postId still names it. 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

Query parameters

Choose fields

Headers

Response

200 OK

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

400 Invalid alias or cursor

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

404 Contributor not found

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.

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

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

429 Rate limit exceeded

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

424 Dependency failed

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

Response examples

200 example

  • 400 { "error": "invalid_contributor_alias", "message": "Send a Community Notes alias or its x.com/i/communitynotes/u URL." }
  • 401 { "error": "unauthenticated", "message": "Authentication required." }
  • 402 { "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 404 { "error": "contributor_not_found", "message": "Contributor not found. Check the alias on its x.com/i/communitynotes/u page." }
  • 424 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }
  • 502 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 503 { "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }