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

# Get a Twitter user's followers by username

`POST /twitter/get-user-followers`

## Request

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

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

## Request body

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

## Response `200`

GetUserFollowers API successful response

- object
  - `followers` 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.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)