> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xquik.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X community notes contributor API for note counts

> Get a Community Notes contributor by alias, with note counts by rating, rating counts, and the deleted notes count. 1 credit per lookup, unknown aliases free.

<Panel>
  <Tabs defaultTabIndex={0} sync={false}>
    <Tab title="200" id="response-x-community-notes-contributor-200">
      ```json theme={null}
      {
        "contributor": {
          "alias": "ardent-beach-friarbird",
          "deletedNotesCount": 0,
          "isApiContributor": false,
          "isTopWriter": false,
          "notesCount": {
            "awaitingMoreRatings": 18,
            "currentlyRatedHelpful": 1,
            "currentlyRatedNotHelpful": 2,
            "updatedAt": "2026-10-12T22:18:40.096Z"
          }
        }
      }
      ```
    </Tab>

    <Tab title="400" id="response-x-community-notes-contributor-400">
      ```json theme={null}
      {
        "error": "invalid_contributor_alias",
        "message": "Send a Community Notes alias or its x.com/i/communitynotes/u URL."
      }
      ```
    </Tab>

    <Tab title="401" id="response-x-community-notes-contributor-401">
      ```json theme={null}
      {
        "error": "unauthenticated",
        "message": "Authentication required."
      }
      ```
    </Tab>

    <Tab title="402" id="response-x-community-notes-contributor-402">
      ```json theme={null}
      {
        "error": "insufficient_credits",
        "message": "Insufficient credits. Top up or subscribe to continue."
      }
      ```
    </Tab>

    <Tab title="404" id="response-x-community-notes-contributor-404">
      ```json theme={null}
      {
        "error": "contributor_not_found",
        "message": "Contributor not found. Check the alias on its x.com/i/communitynotes/u page."
      }
      ```
    </Tab>

    <Tab title="424" id="response-x-community-notes-contributor-424">
      ```json theme={null}
      {
        "error": "x_api_unavailable",
        "message": "X data source temporarily unavailable. Try again later."
      }
      ```
    </Tab>

    <Tab title="429" id="response-x-community-notes-contributor-429">
      ```json theme={null}
      {
        "error": "rate_limit_exceeded",
        "message": "Too many requests. Try again later.",
        "retryAfter": 60
      }
      ```
    </Tab>

    <Tab title="502" id="response-x-community-notes-contributor-502">
      ```json theme={null}
      {
        "error": "x_api_unavailable",
        "message": "X data source temporarily unavailable. Try again later."
      }
      ```
    </Tab>

    <Tab title="503" id="response-x-community-notes-contributor-503">
      ```json theme={null}
      {
        "error": "x_api_unavailable",
        "message": "Xquik is busy right now. Retry shortly."
      }
      ```
    </Tab>
  </Tabs>
</Panel>

<blockquote className="agent-llms-directive">
  For the complete documentation index, see <a href="/llms.txt">llms.txt</a>.
</blockquote>

<Callout icon="coins" color="#5c3327">
  **1 credit per lookup** · [All plans](https://xquik.com/#pricing) from \$0.00012/credit · Supports [guest paid reads](/guides/guest-wallets)
</Callout>

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://xquik.com/api/v1/x/community-notes/contributors/ardent-beach-friarbird" \
    -H "x-api-key: xq_your_api_key_here" | jq
  ```

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

  const { notesCount, ratingsCount } = body.contributor;
  console.log(`${notesCount.currentlyRatedHelpful} notes rated helpful`);
  console.log(`${ratingsCount.successful.total} ratings matched the final rating`);
  ```

  ```python Python theme={null}
  import requests

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

  contributor = body["contributor"]
  print(contributor["notesCount"]["currentlyRatedHelpful"], "notes rated helpful")
  print(contributor["ratingsCount"]["successful"]["total"], "ratings matched the final rating")
  ```
</CodeGroup>

## Who writes a Community Note?

X names each Community Notes contributor by an alias, never by their X account. Use
`GET /x/community-notes/contributors/{alias}` to read 1 contributor's record.

* `notesCount` says how many notes they wrote, by X's current rating.
* `ratingsCount` says how their ratings of other notes went.
* `deletedNotesCount` counts the notes they deleted.

Read what they wrote with [contributor notes](/api-reference/x/community-notes-contributor-notes). Read what they
deleted with [deleted notes](/api-reference/x/community-notes-contributor-deleted-notes).

## Path parameters

<ParamField path="alias" type="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.
</ParamField>

## Query parameters

<ParamField query="fields" type="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.
</ParamField>

<ParamField query="omit" type="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.
</ParamField>

## Headers

<ParamField header="x-api-key" type="string">
  Full account key. Sessions and OAuth also work.
</ParamField>

<ParamField header="Authorization" type="string">
  `Bearer xq_your_guest_key_here` for `paid_reads`.
</ParamField>

## Response

### 200 OK

X leaves out a field it does not send. Only `alias` is always present.

<ResponseField name="contributor" type="object">
  The contributor's record.

  <ResponseField name="alias" type="string">
    The alias X gives the contributor.
  </ResponseField>

  <ResponseField name="isTopWriter" type="boolean">
    Whether X marks the contributor as a top writer.
  </ResponseField>

  <ResponseField name="isApiContributor" type="boolean">
    Whether the contributor writes notes through X's API.
  </ResponseField>

  <ResponseField name="deletedNotesCount" type="number">
    Notes the contributor deleted.
  </ResponseField>

  <ResponseField name="notesCount" type="object">
    How many notes the contributor wrote, by X's current rating. It holds `awaitingMoreRatings`,
    `currentlyRatedHelpful`, `currentlyRatedNotHelpful` & `updatedAt`.
  </ResponseField>

  <ResponseField name="ratingsCount" type="object">
    How the contributor's ratings of other notes went. It holds `awaitingMoreRatings`,
    `ratedAfterDecision`, `successful`, `unsuccessful` & `updatedAt`. `successful` counts the ratings
    that matched the rating X gave the note.
  </ResponseField>
</ResponseField>

### 400 Invalid alias

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

The path named no contributor. This answer is free.

### 404 Contributor not found

```json theme={null}
{
  "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.

```json theme={null}
{ "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

```json theme={null}
{ "error": "x_api_unavailable" }
```

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

<Note>
  **Related.** [Contributor notes](/api-reference/x/community-notes-contributor-notes) · [Deleted notes](/api-reference/x/community-notes-contributor-deleted-notes) · [Get tweet](/api-reference/x/get-tweet)
</Note>

<div className="related-api-links">
  <Accordion title="Related tweet, reply & media APIs" icon="link">
    * Tweets: [Get tweet](/api-reference/x/get-tweet) · [Tweet insights](/api-reference/x/tweet-engagement-insights) · [Batch tweets](/api-reference/x/batch-tweets) · [Tweet thread](/api-reference/x/tweet-thread) · [Hidden replies](/api-reference/x/tweet-hidden-replies) · [Translate tweet](/api-reference/x/tweet-translation) · [Embed tweet](/api-reference/x/tweet-embed) · [Resolve links](/api-reference/x/resolve-links) · [Tweet subtitles](/api-reference/x/tweet-subtitles) · [X Article](/api-reference/x/get-article)
    * Analysis: [Sentiment analysis](/api-reference/x/sentiment-analysis) · [Brand mentions](/api-reference/x/brand-monitoring) · [News classification](/api-reference/x/news-classification) · [Market signals](/api-reference/x/market-signals) · [Viral score](/api-reference/x/viral-score) · [Classify posts](/api-reference/x/classify-tweets)
    * Engagement: [Tweet replies](/api-reference/x/tweet-replies) · [Quote tweets](/api-reference/x/tweet-quotes) · [Likers](/api-reference/x/favoriters) · [Reposters](/api-reference/x/retweeters) · [Reposter IDs](/api-reference/x/retweeter-ids) · [Check repost](/api-reference/x/tweet-repost-check)
    * Profiles: [User tweets](/api-reference/x/user-tweets) · [Batch user tweets](/api-reference/x/batch-user-tweets) · [User replies](/api-reference/x/user-replies) · [User likes](/api-reference/x/user-likes) · [User media](/api-reference/x/user-media) · [User highlights](/api-reference/x/user-highlights) · [User articles](/api-reference/x/user-articles)
    * Feeds: [List tweets](/api-reference/x/list-tweets) · [Trends](/api-reference/x/trends) · [Trends history](/api-reference/x/trends-history) · [Top tweets](/api-reference/x/top-tweets) · [Trend locations](/api-reference/x/trend-locations) · [Search Spaces](/api-reference/x/search-spaces) · [Get Space](/api-reference/x/get-space) · [Space replay](/api-reference/x/space-replay) · [Get broadcast](/api-reference/x/get-broadcast) · [User live status](/api-reference/x/user-live-status) · [Notes contributor](/api-reference/x/community-notes-contributor) · [Contributor notes](/api-reference/x/community-notes-contributor-notes) · [Deleted notes](/api-reference/x/community-notes-contributor-deleted-notes) · [Hashflags](/api-reference/x/hashflags) · [Search places](/api-reference/x/search-places) · [Download media](/api-reference/x/download-media)
  </Accordion>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.