Users

Search users by name or username

Returns public profiles matching a name or username.

get/x/users/search

Query parameters

qstring required

User search query

cursorstring

Pagination cursor for user search

pageSizeinteger

Maximum page items (1-100, default 20). Source, filters, or credits can reduce results. Follow next_cursor while the response reports more pages. Deprecated limit and count aliases remain accepted.

minFollowersinteger

Minimum follower count. Filtering happens before billing.

maxFollowersinteger

Maximum follower count. Missing counts pass this maximum.

minFollowinginteger

Profiles must follow at least this many accounts.

maxFollowinginteger

Profiles may follow at most this many accounts.

minStatusesinteger

Minimum post count. minPosts is also accepted.

maxStatusesinteger

Maximum post count. maxPosts is also accepted.

minAccountAgeDaysinteger

Minimum account age in whole days.

verifiedOnlyboolean

Only return verified profiles.

verifiedTypestring

Match the verification type exactly, ignoring case.

hasWebsiteboolean

Only return profiles with a website.

hasLocationboolean

Only return profiles with a location.

bioContainsstring

Match any comma-separated or line-separated bio term, ignoring case.

locationContainsstring

Match a location substring, ignoring case.

usernameContainsstring

Match a username substring, ignoring case.

enrichProfilesboolean

Add each row's full profile, as GET /x/users/{id} returns it. Pages take several seconds longer.

Response

User search results

filtered_countinteger

has_next_pageboolean required

next_cursorstring required

Example response

{
  "users": [],
  "has_next_page": false,
  "next_cursor": ""
}

Changes

Changed in 12 of the 32 revisions of this API.224032

Sep 27, 2026d9f0c903425524See the full diff
- ●
  added the new draw_too_large enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new draw_too_large enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new retweeters_incomplete enum value to the /////// response property for the response status
  response-property-enum-value-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 26, 2026db02366a5e8d121See the full diff
- ●
  added the new bookmark_folders_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new bookmark_folders_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ○
  added the new optional query request parameter enrichProfiles
  new-optional-request-parameter
Sep 25, 202621bb66373b8912See the full diff
- ●
  added the new search_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new search_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 24, 2026b52c1499267512See the full diff
- ●
  added the new idempotency_in_progress enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 19, 2026102d654209ab12See the full diff
- ●
  added the new likes_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new likes_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 14, 2026904c3a9699c812See the full diff
- ●
  added the new pagination_stalled enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new pagination_stalled enum value to the /////// response property for the response status
  response-property-enum-value-added
Sep 12, 202689d355352e811See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Sep 9, 20260ecb877c65ca12See the full diff
- ●
  added the new x_reply_not_allowed enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new x_reply_not_allowed enum value to the /////// response property for the response status
  response-property-enum-value-added
Aug 24, 20265b381ffca02c25See the full diff
- ▲
  the / response's property type changed from no type to object for status
  response-property-type-changed
- ▲
  the / response's property type changed from no type to object for status
  response-property-type-changed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added 'propertyNames' constraint to the / response property for the status
  response-property-property-names-added
- ○
  added 'propertyNames' constraint to the / response property for the status
  response-property-property-names-added
Aug 19, 202673cd0a1d989c1086See the full diff
- ●
  added the new closed enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new closed enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new expired enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the /////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the /////// response property for the response status
  response-property-enum-value-added
- ○
  added the new optional query request parameter pageSize
  new-optional-request-parameter
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added

Full history (12 revisions)