---
title: "Get an X account's followers"
method: GET
path: "/v1/x/users/{user}/followers"
tags: ["X"]
---

# Get an X account's followers

`GET /v1/x/users/{user}/followers`

## Request

- Base URL: `https://api.weirapp.io`
- URL: `https://api.weirapp.io/v1/x/users/{user}/followers`
- Auth: HTTP bearer

Returns accounts that follow the account, most recent first, as X lists them. X chooses the page size (about 70), so there is no `limit`; paginate with `meta.nextCursor`, which is null after the last page. 404 when the account does not exist, or is protected: a protected account's posts and connections are visible only to accounts it approved. Billed per account returned. The first page also bills one profile lookup, to resolve `{user}`; later pages carry the account in the cursor and do not.

## Path parameters

- `user` string, required: A username, with or without the `@`, or a numeric account id. An all-digit value is read as an id.

## Query parameters

- `cursor` string: Opaque cursor from the previous page's `meta.nextCursor`. Pass it back unchanged, with the same path and query parameters; a cursor from another request is rejected with 400.

## Response `200`

Followers, most recent first.

- object
  - `data` object[], required
    - `id` string, required
    - `username` string, required: Handle without the `@` prefix.
    - `name` string, required: Display name.
    - `description` string, nullable, required
    - `url` string, required
    - `profileImageUrl` string, nullable, required
    - `profileBannerUrl` string, nullable, required
    - `location` string, nullable, required
    - `verified` boolean, required
    - `followersCount` integer, required
    - `followingCount` integer, required
    - `statusesCount` integer, required: Posts published.
    - `likeCount` integer, required
    - `createdAt` string, date-time, required
    - `pinnedPostIds` string[], required: Ids of the posts pinned to the top of the profile, usually zero or one.
    - `protected` boolean, required: True when only approved followers can see this account's posts. Its posts, replies, media, and relationship lists are then not available through this API.
  - `meta` object, required
    - `requestId` string, required
    - `nextCursor` string, nullable

## Other responses

- `400`: The request failed validation.
- `401`: The API key is missing, malformed, expired, or revoked.
- `402`: The account is out of credit. Not retryable: this cannot clear until the billing period resets or the plan changes.
- `403`: The API key does not carry the scope this route requires.
- `404`: The requested resource does not exist.
- `429`: The per-minute rate limit is exhausted. Retryable: wait for Retry-After and try again.
- `500`: An unexpected error occurred.
- `503`: The source is temporarily unavailable. The request is safe to retry.

---

[API](https://skmtc.dev/weirapp/apis/weir-api.md) · [All operations](https://skmtc.dev/weirapp/apis/weir-api/llms.txt) · [OpenAPI document](https://skmtc.dev/weirapp/apis/weir-api/revisions/4c6a9ae0bfca?raw)