Get an X user's public profile

POST/v1/tools/x.user.profile/callsNeeds an API key

Returns an X user's public profile, with bio, follower count and post count. Use it to look up an account.

Tool x.user.profile on X (Twitter). Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

usernamestringRequired

The user's handle, without the @.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`user`

One object. Can be null.

idstring

X's numeric identifier of the user, as a string.

usernamestringRequired

The user's handle, without the @. The profile is at https://x.com/ followed by it.

namestring

The user's display name.

biostring

The text of the user's profile.

bio_linkstring

The link on the user's profile.

locationstring

Where the user says they are, as they wrote it.

image_urlstring

Address of the user's profile picture.

banner_image_urlstring

Address of the image across the top of the user's profile.

verifiedboolean

Whether X marks the user as verified.

privateboolean

Whether the account is protected, its posts shown only to approved followers.

created_atstring

When the account was created, in ISO 8601.

follower_countinteger

following_countinteger

Number of accounts the user follows.

post_countinteger

Number of posts the user published, reposts and replies included.

like_countinteger

Number of posts the user liked.

curl https://api.voxoria.ai/v1/tools/x.user.profile/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"username":"OpenAI"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/x.user.profile/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"username": "OpenAI"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/x.user.profile/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"username": "OpenAI"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "x.user.profile",
    "input": {
      "username": "OpenAI"
    }
  }
}

200 OKoutputapplication/json

{
  "user": {
    "id": "4398626122",
    "username": "OpenAI",
    "name": "OpenAI",
    "bio": "OpenAI’s mission is to ensure that artificial general intelligence benefits all of humanity. We’re hiring: https://t.co/dJGr6LgzPA",
    "bio_link": null,
    "location": null,
    "image_url": "https://pbs.twimg.com/profile_images/1885410181409820672/ztsaR0JW_normal.jpg",
    "banner_image_url": "https://pbs.twimg.com/profile_banners/4398626122/1777662919",
    "verified": true,
    "private": false,
    "created_at": "2015-12-06T22:51:08Z",
    "follower_count": 5484617,
    "following_count": 4,
    "post_count": 2205,
    "like_count": null
  }
}

The output of a real call, each list cut to 3 items.