Twitter User API

Get an X profile by handle: display name, bio, location, website, avatar and banner, follower, following, tweet and like counts, verification status, pinned tweet and join date.

Endpoint: POST /x/get-user
Price: 1 credit per request
SDK: client.x.getUser()
MCP tool: x_get_user

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/x/get-user" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "handle": "elonmusk"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/x/get-user",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "handle": "elonmusk",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/x/get-user", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "handle": "elonmusk"
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.x.getUser({
  handle: "elonmusk"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Twitter User API return?

Twitter profile API: get any X (Twitter) profile by handle with bio, location, website, follower and following counts, verification, join date and user ID. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

handlestringrequired: X handle / screen name, with or without the @, or the profile link, e.g. "elonmusk" or "https://x.com/elonmusk".

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "userId": "string",
    "username": "string",
    "profileUrl": "string",
    "displayName": "string",
    "bio": "string",
    "avatarUrl": "string",
    "bannerUrl": "string",
    "location": "string",
    "websiteUrl": "string",
    "bioUrls": [
      {
        "url": "string",
        "displayUrl": "string"
      }
    ],
    "followerCount": 0,
    "followingCount": 0,
    "fastFollowersCount": 0,
    "normalFollowersCount": 0,
    "tweetCount": 0,
    "likeCount": 0,
    "mediaCount": 0,
    "listedCount": 0,
    "creatorSubscriptionsCount": 0,
    "highlightedTweetsCount": 0,
    "pinnedTweetId": "string",
    "pinnedTweetUrl": "string",
    "isVerified": true,
    "isBlueVerified": true,
    "verifiedType": "string",
    "isIdentityVerified": true,
    "isProtected": true,
    "canDm": true,
    "professionalType": "string",
    "professionalId": "string",
    "professionalCategoryId": 0,
    "professionalCategoryName": "string",
    "affiliate": {
      "label": "string",
      "username": "string",
      "profileUrl": "string",
      "badgeUrl": "string"
    },
    "tipJar": {
      "isEnabled": true,
      "bitcoinHandle": "string",
      "ethereumHandle": "string",
      "venmoHandle": "string",
      "venmoUrl": "string",
      "cashAppHandle": "string",
      "cashAppUrl": "string",
      "patreonHandle": "string",
      "patreonUrl": "string"
    },
    "createdAt": "2026-01-15T09:30:00.000Z"
  }
}

[ USE CASES ]

What can you build with the Twitter User API?

Enrich contacts

Add bio, follower count and location to a handle in your CRM.

Vet influencers

Check audience size and verification before a partnership.

Get a user ID

Look up the numeric ID that timeline and follower lookups take.

[ FAQ ]

Twitter User API questions

How do I get a Twitter user ID from a username?

Send the handle, with or without the @. The response includes the numeric user ID, which the tweets, replies, media, followers and following endpoints take as userId.

How do I get a Twitter account’s follower count?

Look the account up by handle. The response has follower, following, tweet and like counts, plus bio, location, website, verification status, pinned tweet and join date.

Can I track the follower growth of an X account?

Yes. Look the account up daily and record the follower count. Each lookup costs 1 credit.

How do I use the Twitter User API?

Send a POST request to https://api.bridgly.app/x/get-user with handle in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.x.getUser(). AI agents connected to Bridgly over MCP can call the x_get_user tool.

How much does the Twitter User API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

Try it with a free tool

Look up a public example in your browser before connecting the API. No account needed.

X (Twitter)Twitter Profile ViewerEnter a handle to see the followers, bio, join date and verification of any X profile, without logging in.Open tool →

[ MORE ENDPOINTS ]

More X (Twitter) endpoints

The same API key works on every endpoint. See all X (Twitter) API endpoints.

Try the Twitter User API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs