datasets_x_users_search
Search X (Twitter) user profiles with filters for followers, verification, bio, and date range. Sort by relevance or follower count.
Instructions
Search the X users dataset. Searches public X (Twitter) user profiles stored in a search index. Sort enum: relevance, followers_desc, followers_asc, crawled_at_desc, crawled_at_asc, created_at_desc, created_at_asc.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text query over username, name, bio and location, max 256 characters | |
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: relevance, followers_desc, followers_asc, crawled_at_desc, crawled_at_asc, created_at_desc, created_at_asc | |
| has_bio | No | Filter by a non-empty profile bio | |
| username | No | Exact username filter (case-insensitive), max 128 characters | |
| max_ratio | No | Maximum follower-to-following ratio | |
| min_ratio | No | Minimum follower-to-following ratio (low values surface follow-spam / bot-like accounts) | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| source_tier | No | Exact filter for which seed tier discovered this account, e.g. github-users, wikidata, tiktok-creators, journalists | |
| crawled_after | No | Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD) | |
| created_after | No | Accounts created on or after this date (RFC3339 or YYYY-MM-DD) | |
| max_followers | No | Maximum follower count | |
| min_followers | No | Minimum follower count | |
| crawled_before | No | Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD) | |
| created_before | No | Accounts created on or before this date (RFC3339 or YYYY-MM-DD) | |
| has_external_url | No | Filter by a linked external URL | |
| is_blue_verified | No | Filter by the X blue-check verification flag |