User Search


Scope: none

Retrieve a list of users filtered by the given criteria.

Query Parameters


Name Description
q List of words included in user profiles or names


Name Description
order One of id or relevance. Default is by relevance when a q value is set


Name Description
created_after ISO 8601-formatted timestamp after which users were created
created_before ISO 8601-formatted timestamp before which users were created
is_follower Whether to include users who follow you. Requires authentication
is_following Whether to include users who you are following. Requires authentication
locale Valid user locale e.g., en_US
timezone Valid user timezone e.g., America/Chicago
user_types Comma-separated list of user types of: human, feed, bot
curl "" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of users

    "meta": {
        "more": false,
        "max_id": "0",
        "min_id": "0",
        "code": 200
    "data": [
        {"...User Object..."},
        {"...User Object..."}