Twitter User Search API

Search X accounts by name or keyword. Each result includes the handle, display name, bio, location, website, avatar and follower, following and tweet counts.

Endpoint: POST /x/search/users
Price: 1 credit per result
SDK: client.x.searchUsers()
MCP tool: x_search_users

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/x/search/users" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "openai",
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/x/search/users",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "query": "openai",
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/x/search/users", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "query": "openai",
    "count": 10
  }),
});
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.searchUsers({
  query: "openai",
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Twitter User Search API return?

Twitter user search API: find X (Twitter) accounts by name or keyword, with handle, name, bio, location, website and follower, following and tweet counts. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

querystringrequired: Raw search query — supports all X advanced-search operators, e.g. "openai lang:en".
cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.
countinteger · 1–20 · default 10: Number of results to return (1–20). Defaults to 10.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "users": [
      {
        "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 Search API?

Find accounts by topic

Search a keyword to list the accounts that describe themselves with it.

Resolve handles

Match a person or company name to its X account.

Build creator lists

Find accounts in a niche and rank them by followers.

[ FAQ ]

Twitter User Search API questions

How do I find Twitter accounts by keyword?

Send a name or keyword as the query. Each account comes back with handle, display name, bio, location, website, avatar and follower, following and tweet counts.

Can I find influencers in a niche on X?

Yes. Search the topic, then sort the accounts by follower count and read their bios. Open the ones you like with the Twitter User Tweets API to see what they post.

How do I get more than 20 accounts from a Twitter user search?

Set count to up to 20 accounts per call (10 by default), then send the nextCursor from each response back as cursor to get the next page; it is null once there are no more results.

How do I use the Twitter User Search API?

Send a POST request to https://api.bridgly.app/x/search/users with query in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.x.searchUsers(). AI agents connected to Bridgly over MCP can call the x_search_users tool.

How much does the Twitter User Search API cost?

Costs 1 credit per result returned, with a minimum of 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.

[ MORE ENDPOINTS ]

More X (Twitter) endpoints

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

Try the Twitter User Search 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