---
title: "Get a Twitter user's followings by username"
method: POST
path: "/twitter/get-user-followings"
tags: ["Twitter"]
---

# Get a Twitter user's followings by username

`POST /twitter/get-user-followings`

## Request

- Base URL: `https://api.exfunc.dev`
- URL: `https://api.exfunc.dev/twitter/get-user-followings`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/carvedai/apis/exfunc-apis/docs/twitter/get-user-followings/post.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of followings given a Twitter username (handle)

## Request body

- object
  - `username` string, required: The username of the Twitter user whose followings to retrieve
  - `count` integer: The number of followings to retrieve

## Response `200`

GetUserFollowings API successful response

- object
  - `followings` TwitterUser[]
    - `user_id` string: Unique identifier for the user
    - `username` string: The user's username
    - `name` string: The name of the user
    - `description` string: A brief description of the user
    - `url` string, uri: The attached URL on the user's profile page
    - `following_count` integer: Number of users the user is following
    - `follower_count` integer: Number of followers the user has

## Other responses

- `400`: User error response
- `500`: Server error response

## Changes

- **2024-11-04** `74bc9782b6a9`: 1 warning, 1 info
  - removed the optional property `tweets` from the response with the `200` status
  - added the optional property `followings` to the response with the `200` status

[Operation history](https://skmtc.dev/carvedai/apis/exfunc-apis/changes/twitter/get-user-followings/post.md)

---

[API](https://skmtc.dev/carvedai/apis/exfunc-apis.md) - [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/carvedai/apis/exfunc-apis/revisions/22587fdf9a5e?raw)