> ## Documentation Index > Fetch the complete documentation index at: https://docs.twitterapi.io/llms.txt > Use this file to discover all available pages before exploring further. # Get 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). ## OpenAPI ````yaml GET /twitter/user/followings openapi: 3.0.1 info: title: TwitterAPI.io the most stable/fastest/cheapest twitter api. description: Provide the most stable/fastest/cheapest twitter api. license: name: MIT version: 1.0.0 servers: - url: https://api.twitterapi.io security: - ApiKeyAuth: [] paths: /twitter/user/followings: get: description: >- 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). parameters: - name: userName in: query description: screen name of the user required: true schema: type: string format: string - name: cursor in: query description: The cursor to paginate through the results. First page is "". schema: type: string format: string - name: pageSize in: query description: >- The number of followings to return per page. Default is 200.min 20,max 200 schema: type: integer default: 200 responses: '200': description: User followings content: application/json: schema: type: object properties: followings: type: array items: $ref: '#/components/schemas/UserInfoBasic' description: Array of followings has_next_page: type: boolean description: Indicates if there are more results available next_cursor: type: string description: Cursor for fetching the next page of results status: type: string description: Status of the request.success or error enum: - success - error message: type: string description: Message of the request.error message '400': description: unexpected error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: UserInfoBasic: type: object description: >- Basic user info without verification fields. Used by followers/followings endpoints. properties: type: type: string enum: - user userName: type: string description: The username of the Twitter user url: type: string description: The x.com URL of the user's profile id: type: string description: The unique identifier of the user name: type: string description: The display name of the user profilePicture: type: string description: URL of the user's profile picture coverPicture: type: string description: URL of the user's cover picture description: type: string description: The user's profile description location: type: string description: 'The user''s location.for example: 東京の端っこ . may be empty' followers: type: integer description: Number of followers following: type: integer description: Number of accounts following canDm: type: boolean description: Whether the user can receive DMs createdAt: type: string description: >- When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007 favouritesCount: type: integer description: Number of favorites hasCustomTimelines: type: boolean description: Whether the user has custom timelines isTranslator: type: boolean description: Whether the user is a translator mediaCount: type: integer description: Number of media posts statusesCount: type: integer description: Number of status updates withheldInCountries: type: array items: type: string description: Countries where the account is withheld affiliatesHighlightedLabel: type: object possiblySensitive: type: boolean description: Whether the account may contain sensitive content pinnedTweetIds: type: array items: type: string description: IDs of pinned tweets isAutomated: type: boolean description: Whether the account is automated automatedBy: type: string description: The account that automated the account unavailable: type: boolean description: Whether the account is unavailable message: type: string description: >- The message of the account.eg. "This account is unavailable" or "This account is suspended" unavailableReason: type: string description: 'The reason the account is unavailable.eg. "suspended" ' profile_bio: type: object properties: description: type: string entities: type: object properties: description: type: object properties: urls: type: array items: type: object properties: display_url: type: string expanded_url: type: string indices: type: array items: type: integer url: type: string url: type: object properties: urls: type: array items: type: object properties: display_url: type: string expanded_url: type: string indices: type: array items: type: integer url: type: string Error: required: - error - message type: object properties: error: type: integer format: int32 message: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ````