Search

Search users

Find users via various criteria. (This method returns up to 100 results per page.)

The q search term can also contain any combination of the supported user search qualifiers as described by the in-browser user search documentation and search syntax documentation:

• type With this qualifier you can restrict the search to just personal accounts (user) or just organization accounts (org).
• in Qualifies which fields are searched. With this qualifier you can restrict the search to just the username (login), public email (email), full name (fullname), or any combination of these.
• repos Filters users based on the number of repositories they have.
• location Filter users by the location indicated in their profile.
• language Search for users that have repositories that match a certain language.
• created Filter users based on when they joined.
• followers Filter users based on the number of followers they have.

Request

Name	Value	Description	Example	Type	Constraints	Default
Query parameters
order		The sort order if sort parameter is provided. One of asc or desc.		string?		desc
q		The search terms.	tom+repos:%3E42+followers:%3E1000	string?
sort		The sort field. Can be followers, repositories, or joined. Default: results are sorted by best match.		string?
Headers

Responses

Code	Description	Headers	Body
200			application/json | example { "total_count": 12, "incomplete_results": false, "items": [{ "login": "mojombo", "id": 1, "avatar_url": "https://secure.gravatar.com/avatar/25c7c18223fb42a4c6ae1c8db6f50f9b?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png", "gravatar_id": "", "url": "https://api.github.com/users/mojombo", "html_url": "https://github.com/mojombo", "followers_url": "https://api.github.com/users/mojombo/followers", "subscriptions_url": "https://api.github.com/users/mojombo/subscriptions", "organizations_url": "https://api.github.com/users/mojombo/orgs", "repos_url": "https://api.github.com/users/mojombo/repos", "received_events_url": "https://api.github.com/users/mojombo/received_events", "type": "User", "score": 105.47857 }] } { "total_count": 12, "incomplete_results": false, "items": [{ "login": "mojombo", "id": 1, "avatar_url": "https://secure.gravatar.com/avatar/25c7c18223fb42a4c6ae1c8db6f50f9b?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-user-420.png", "gravatar_id": "", "url": "https://api.github.com/users/mojombo", "html_url": "https://github.com/mojombo", "followers_url": "https://api.github.com/users/mojombo/followers", "subscriptions_url": "https://api.github.com/users/mojombo/subscriptions", "organizations_url": "https://api.github.com/users/mojombo/orgs", "repos_url": "https://api.github.com/users/mojombo/repos", "received_events_url": "https://api.github.com/users/mojombo/received_events", "type": "User", "score": 105.47857 }] }

Send request Use modified URL

Request URL Request Headers

Response Code

Response Headers

Response | Preview