Twitter Search Users API

Search Twitter/X users by keyword. Returns profile data including username, display name, bio, follower/following counts, verification status, and profile image. Supports fetching multiple pages of results in a single API call.

Price: $0.006 per page

Free tier: 50 requests/month

Get API Key Documentation

Endpoint

GET /v1/twitter/users

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch, 1-10 (default: 1)

Response fields

users

Array of matching user profiles

username

Twitter username (handle)

name

Display name

user_id

Twitter user ID

description

Bio / profile description

followers_count

Number of followers

following_count

Number of accounts followed

tweet_count

Total tweets posted

verified

Whether the user is verified (blue checkmark)

profile_image_url

URL to profile image

created_at

Account creation date

url

Link to the profile

pages

Number of pages fetched

count

Total results returned

Example Request

curl "https://apidirect.io/v1/twitter/users?query=AI&pages=1" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/twitter/users",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "AI",
        "pages": 1
    }
)
print(response.json())

Example Response

{
  "users": [
    {
      "username": "OpenAI",
      "name": "OpenAI",
      "user_id": "4398626122",
      "description": "Creating safe AGI that benefits all of humanity.",
      "followers_count": 3842150,
      "following_count": 0,
      "tweet_count": 2145,
      "verified": true,
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "created_at": "2015-12-09 20:42:45",
      "url": "https://twitter.com/OpenAI"
    }
  ],
  "pages": 1,
  "count": 20
}

Frequently asked questions

What user data is returned?

Each result includes username, display name, user ID, bio, follower/following counts, tweet count, verification status, profile image URL, account creation date, and a link to the profile.

How is this different from the User Profile endpoint?

The Search Users endpoint finds users by keyword (searching across usernames and bios), while the User Profile endpoint returns detailed data for a single known username. Use Search Users for discovery, User Profile for detailed lookups.

How many results per page?

Each page returns up to 20 user results. You can fetch up to 10 pages (200 users) in a single request.

How does pricing work?

You only pay for successful requests. The Twitter Search Users API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.