Endpoint Playground
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`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100). Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 1 items; 25 fields had a value in every checked item.
Sample value profiles: created_at: 2009-06-24; external_url: gatesnot.es; is_blue_verified: true in 1 of 1.
curl 'https://api.crawlora.net/api/v1/datasets/x-users/search?sort=relevance' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text query over username, name, bio and location, max 256 characters | |
| username | string | No | Exact username filter (case-insensitive), max 128 characters | |
| source_tier | string | No | Exact filter for which seed tier discovered this account, e.g. github-users, wikidata, tiktok-creators, journalists | |
| is_blue_verified | boolean | No | Filter by the X blue-check verification flag | |
| has_bio | boolean | No | Filter by a non-empty profile bio | |
| has_external_url | boolean | No | Filter by a linked external URL | |
| min_followers | integer | No | Minimum follower count | |
| max_followers | integer | No | Maximum follower count | |
| min_ratio | number | No | Minimum follower-to-following ratio (low values surface follow-spam / bot-like accounts) | |
| max_ratio | number | No | Maximum follower-to-following ratio | |
| created_after | string | No | Accounts created on or after this date (RFC3339 or YYYY-MM-DD) | |
| created_before | string | No | Accounts created on or before this date (RFC3339 or YYYY-MM-DD) | |
| crawled_after | string | No | Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD) | |
| crawled_before | string | No | Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD) | |
| sort | string | No | relevance | Sort enum: relevance, followers_desc, followers_asc, crawled_at_desc, crawled_at_asc, created_at_desc, created_at_asc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "x-users",
"items": [
{
"username": "octodev",
"name": "Octo Dev",
"bio": "Building things in public",
"location_raw": "Berlin, Germany",
"external_url": "https://octo.dev",
"avatar_url": "https://pbs.twimg.com/profile_images/example_normal.jpg",
"is_blue_verified": true,
"has_bio": true,
"has_external_url": true,
"followers": 12000,
"following": 800,
"posts": 3400,
"follower_following_ratio": 15,
"source_tier": "github-users",
"crawled_at": "2026-07-14T09:53:36Z",
"schema_version": 1
}
],
"page": 1,
"page_size": 20,
"total": 1,
"sort": "followers_desc"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.