Back to Hub

X Get User Profile

HTTP Official API

Look up an X (Twitter) user profile by username. Returns bio, follower/following counts, verified status, and account details.

Tony CostanzoTony Costanzo
0 installs
v1.0.0
Mar 31, 2026
Workspace secrets required
This tool references workspace secrets. After installing, you'll need to configure the required secrets in Settings → Integrations and create a new secret for the tool to work.

X Get User Profile

Official Look up any X (Twitter) user's profile, bio, and follower stats.

What this tool does: Retrieves a user's X profile by username using the X API v2. Returns their display name, bio, location, follower/following counts, verified status, account creation date, and profile image. Useful for research, lead qualification, or competitor analysis.

Setup

Follow the setup in X Search Tweets if you haven't already. This tool uses the same X_API_KEY secret.

Never paste API keys directly into tool definitions. Always use workspace secrets.

Parameters

ParameterRequiredDescription
usernameYesX username without the @ symbol (e.g., elonmusk)

Example Prompts

Try these with your agent:

  • "Look up the X profile for @paulg"
  • "Get me the follower count and bio for cognaborations on Twitter"
  • "Who is @levelsio? Pull up their X profile"

Tool Definition

Input Parameters

usernamestringThe X username to look up (without the @ symbol). For example: 'elonmusk' not '@elonmusk'.

HTTP Configuration

Method: GET
URL: https://api.twitter.com/2/users/by/username/{{input.username}}?user.fields=description,public_metrics,verified,created_at,location,url,profile_image_url