---
title: "GET /twitter/user/followings"
method: GET
path: "/twitter/user/followings"
---

# GET /twitter/user/followings

`GET /twitter/user/followings`

Get user followings (with full profile metadata). Sorted by follow date — most recent followings appear on the first page. Use `cursor` for pagination.

## Tiered pricing (per following returned)

> **Credits ↔ USD:** 100,000 credits = $1.00 (1 credit ≈ $0.00001)

| Returned followings per call | Price | USD equivalent |
|---|---|---|
| 200 (max page size) | **1 credit / following** | **$0.01 / 1k followings** |
| 100 - 199 | 2 credits / following | $0.02 / 1k followings |
| 20 - 99 | 3 credits / following | $0.03 / 1k followings |

💡 **At max page size, 100,000 following profiles cost just $1.00.**

Minimum charge: **60 credits ($0.0006)** per call (20 followings × 3 credits, the smallest page size).

## Query parameters

- `userName` string, string, required
- `cursor` string, string
- `pageSize` integer

## Response `200`

User followings

- object
  - `followings` UserInfoBasic[] — Array of followings
    - `type` 'user'
    - `userName` string — The username of the Twitter user
    - `url` string — The x.com URL of the user's profile
    - `id` string — The unique identifier of the user
    - `name` string — The display name of the user
    - `profilePicture` string — URL of the user's profile picture
    - `coverPicture` string — URL of the user's cover picture
    - `description` string — The user's profile description
    - `location` string — The user's location.for example: 東京の端っこ . may be empty
    - `followers` integer — Number of followers
    - `following` integer — Number of accounts following
    - `canDm` boolean — Whether the user can receive DMs
    - `createdAt` string — When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
    - `favouritesCount` integer — Number of favorites
    - `hasCustomTimelines` boolean — Whether the user has custom timelines
    - `isTranslator` boolean — Whether the user is a translator
    - `mediaCount` integer — Number of media posts
    - `statusesCount` integer — Number of status updates
    - `withheldInCountries` string[] — Countries where the account is withheld
    - `affiliatesHighlightedLabel` object
    - `possiblySensitive` boolean — Whether the account may contain sensitive content
    - `pinnedTweetIds` string[] — IDs of pinned tweets
    - `isAutomated` boolean — Whether the account is automated
    - `automatedBy` string — The account that automated the account
    - `unavailable` boolean — Whether the account is unavailable
    - `message` string — The message of the account.eg. "This account is unavailable" or "This account is suspended"
    - `unavailableReason` string — The reason the account is unavailable.eg. "suspended"
    - `profile_bio` object
      - `description` string
      - `entities` object
        - `description` object
          - `urls` object[]
            - `display_url` string
            - `expanded_url` string
            - `indices` integer[]
            - `url` string
        - `url` object
          - `urls` object[]
            - `display_url` string
            - `expanded_url` string
            - `indices` integer[]
            - `url` string
  - `has_next_page` boolean — Indicates if there are more results available
  - `next_cursor` string — Cursor for fetching the next page of results
  - `status` 'success' | 'error' — Status of the request.success or error
  - `message` string — Message of the request.error message

## Other responses

- `400` — unexpected error

---

[API](https://skmtc.net/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api.md) · [All operations](https://skmtc.net/twitterapi/apis/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twitterapi/twitterapi-io-the-most-stable-fastest-cheapest-twitter-api/revisions/1b1afaf3df76/schema)