---
title: "User › Followers"
method: GET
path: "/v1/twitter/user/followers"
tags: ["twitter"]
---

# User › Followers

`GET /v1/twitter/user/followers`

## Request

- Base URL: `https://api.insightsocial.app`
- URL: `https://api.insightsocial.app/v1/twitter/user/followers`
- Auth: API key in header `x-api-key`

Returns the accounts following an X (Twitter) user, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date.

Use it to sample an account's audience. Page size is set by X, around 70 accounts, and the cursor pages deeper; verification status is not readable here and returns null.

**10 credits** per call.

Paginates by `cursor`: see [Pagination](https://www.insightsocial.app/docs/pagination).

## Query parameters

- `handle` string, required
- `cursor` string
- `dry_run` '1'

## Response `200`

Success.

- object
  - `success` true, required
  - `platform` string, required
  - `endpoint` string, required
  - `schema_version` '2', required
  - `data` ProfilePage, required
    - `items` object[], required
      - `author` Profile, required
        - `id` string, required: An identifier, always a string. Never parse it as a number: several platforms use ids above 2^53.
        - `username` string, nullable, required
        - `display_name` string, nullable, required
        - `avatar_url` string, uri, nullable, required
        - `bio` string, nullable, required
        - `verified` boolean, nullable, required
        - `followers` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `followers_approximate` boolean, nullable, required
        - `following` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `posts_count` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `likes_count` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
        - `url` string, uri, nullable, required
        - `location` string, nullable, required
        - `external_url` string, uri, nullable, required
        - `private` boolean, nullable, required
        - `joined_at` string, date-time, nullable, required: ISO-8601 timestamp in UTC, ending in Z.
        - `last_post_at` string, date-time, nullable, required: ISO-8601 timestamp in UTC, ending in Z.
        - `ext` object, nullable, required: Platform-specific fields, snake_case. The key list per platform is in the docs.
    - `total` integer, nullable, required: A count. null when the platform does not expose it; 0 only when it is really zero.
    - `truncated` boolean, nullable, required
    - `ext` object, nullable: Platform-specific fields, snake_case. The key list per platform is in the docs.
  - `pagination` Pagination
    - `next_cursor` string, nullable, required
    - `has_more` boolean, required
    - `page_size` integer, required
    - `stopped_at` 'since' | 'known_id' | 'end', nullable
  - `unavailable` string[], required
  - `credits_used` integer, required
  - `credits_remaining` integer, required
  - `request_id` string, required
  - `cached` boolean, required
  - `idempotent_replay` boolean, required
  - `charge_reason` string, required
  - `free_call` boolean, required

## Other responses

- `400`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `401`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `402`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `404`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `409`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `429`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `500`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `503`: See [Error handling](https://www.insightsocial.app/docs/errors).

---

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