Datasets

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. 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).

get/datasets/x-users/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/x-users/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over username, name, bio and location, max 256 characters

usernamestring

Exact username filter (case-insensitive), max 128 characters

source_tierstring

Exact filter for which seed tier discovered this account, e.g. github-users, wikidata, tiktok-creators, journalists

is_blue_verifiedboolean

Filter by the X blue-check verification flag

has_bioboolean

Filter by a non-empty profile bio

has_external_urlboolean

Filter by a linked external URL

min_followersinteger

Minimum follower count

max_followersinteger

Maximum follower count

min_rationumber

Minimum follower-to-following ratio (low values surface follow-spam / bot-like accounts)

max_rationumber

Maximum follower-to-following ratio

created_afterstring

Accounts created on or after this date (RFC3339 or YYYY-MM-DD)

created_beforestring

Accounts created on or before this date (RFC3339 or YYYY-MM-DD)

crawled_afterstring

Records last refreshed on or after this date (RFC3339 or YYYY-MM-DD)

crawled_beforestring

Records last refreshed on or before this date (RFC3339 or YYYY-MM-DD)

sort'relevance' | 'followers_desc' | 'followers_asc' | 'crawled_at_desc' | 'crawled_at_asc' | 'created_at_desc' | 'created_at_asc'

Sort enum: relevance, followers_desc, followers_asc, crawled_at_desc, crawled_at_asc, created_at_desc, created_at_asc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.