---
title: "Get a Twitter user by either user ID or username"
method: POST
path: "/twitter/get-user"
tags: ["Twitter"]
---

# Get a Twitter user by either user ID or username

`POST /twitter/get-user`

Get user details given a Twitter user ID or username (handle)

## Request body

- object
  - `user_id` string — The ID of the Twitter user to retrieve
  - `username` string — The username of the Twitter user to retrieve

## Response `200`

GetUser API successful response

- object
  - `user` 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)