---
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`

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

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)