Social Fetch
Start for freeStart free
Stack Overflow hub

Stack Overflow Users Search API

Find users by part of their display name, sorted by reputation or join date, with optional profile text.

GET /v1/stack-overflow/users/search

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/stack-overflow/users/search?name=skeet returns a page of users whose display name contains the text, not case sensitive. Each row has the same fields as the single user route, including reputation, badges, acceptRate, questionCount, answerCount and profileViews. Add include=about for aboutHtml; with it, limit is at most 25.

Sort by reputation (the default), creation, name or modified. reputationMin and reputationMax need the reputation sort; joinedAfter and joinedBefore need the creation sort. The creation sort is the only one that pages without a ceiling; the rest return up to 2,500 rows (625 with include=about), then stop and set limitReached. Rows with equal values can repeat or skip on those sorts. Every search is HTTP 200, with an empty list when nobody matched.

Stack Overflow Users Search API FAQ

Does the name match have to be exact?

No. name is a part of the display name and the match is not case sensitive. Use the sort to put the most reputable or the most recent matches first.

How many credits does a users search cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

Can I find users by reputation range?

Yes, with reputationMin and reputationMax, but only when sort=reputation. Any other sort refuses the range.

Can I find users by join date?

Yes, with joinedAfter and joinedBefore, but only when sort=creation. creation also happens to be the sort that pages without a ceiling.

Other Stack Overflow endpoints