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
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.ratingStatussays how X rates the note now, such asNeedsMoreRatingsorCurrentlyRatedHelpful.helpfulTags¬HelpfulTagssay why raters called it helpful or not.timeToHelpfulFromNoteMssays how long the note took to be rated helpful.postis the post the note is on. It has the same fields as Get tweet.
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 returnshas_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. Onlyid is always present.400 Invalid alias or cursor
A cursor X never issued returnsinvalid_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 getWWW-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 theRetry-After header before retrying.424 Dependency failed
The normalized v1 response contract can return 424 when the read service is unavailable.Related. Get notes contributor · Deleted notes · Get tweet
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." }