GitHub User Search API

Search GitHub users and organizations by keyword, name, location, language, follower count, repository count or join date. Each result includes the username, name, bio, location and follower and repository counts.

Endpoint: POST /github/search-users
Price: 1 credit per request
SDK: client.github.searchUsers()
MCP tool: github_search_users

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/github/search-users" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "location": "Berlin",
  "language": "Rust",
  "sort": "followers",
  "count": 10
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/github/search-users",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "location": "Berlin",
        "language": "Rust",
        "sort": "followers",
        "count": 10,
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/github/search-users", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "location": "Berlin",
    "language": "Rust",
    "sort": "followers",
    "count": 10
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.github.searchUsers({
  location: "Berlin",
  language: "Rust",
  sort: "followers",
  count: 10
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the GitHub User Search API return?

Find GitHub developers and organizations by location, language, followers and join date. Get bios and repository counts with the GitHub User Search API. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

querystring: Free-text search terms, matched against the default fields for this search type, e.g. "web framework".
typeenum: Restrict to users or organizations. Maps to `type:`.; user | org
fullNamestring: Match a display name, e.g. "Grace Hopper". Maps to `fullname:`.
locationstring: Profile location, e.g. "San Francisco". Maps to `location:`.
languagestring: Users who code in this language. Maps to `language:`.
followersobject: Filter by follower count. Provide any of gt / gte / lt / lte; combine a lower and upper bound for a range.
followers.gtnumber · nullable: Strictly greater than this value.
followers.gtenumber · nullable: Greater than or equal to this value.
followers.ltnumber · nullable: Strictly less than this value.
followers.ltenumber · nullable: Less than or equal to this value.
reposobject: Filter by public repository count. Provide any of gt / gte / lt / lte; combine a lower and upper bound for a range.
repos.gtnumber · nullable: Strictly greater than this value.
repos.gtenumber · nullable: Greater than or equal to this value.
repos.ltnumber · nullable: Strictly less than this value.
repos.ltenumber · nullable: Less than or equal to this value.
createdobject: Filter by account creation date. Provide any of gt / gte / lt / lte as YYYY-MM-DD dates; combine a lower and upper bound for a range.
created.gtstring · nullable: Strictly after this date (YYYY-MM-DD).
created.gtestring · nullable: On or after this date (YYYY-MM-DD).
created.ltstring · nullable: Strictly before this date (YYYY-MM-DD).
created.ltestring · nullable: On or before this date (YYYY-MM-DD).
sortenum · default best-match: Sort field. Defaults to relevance ("best-match").; best-match | followers | repositories | joined
orderenum · default desc: Sort direction. Defaults to "desc".; desc | asc
countinteger · 1–10 · default 10: Number of results to return (1–10). Defaults to 10.
cursorstring: The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "nextCursor": "string",
    "query": "string",
    "totalCount": 0,
    "users": [
      {
        "id": "string",
        "type": "string",
        "username": "string",
        "name": "string",
        "bio": "string",
        "avatarUrl": "string",
        "url": "string",
        "location": "string",
        "followersCount": 0,
        "repositoriesCount": 0
      }
    ]
  }
}

[ USE CASES ]

What can you build with the GitHub User Search API?

Source developers

Find engineers in a city who write a given language.

Find organizations

List companies on GitHub by location or size.

Rank by influence

Sort developers in a field by follower count.

[ FAQ ]

GitHub User Search API questions

How do I find developers on GitHub by location and language?

Set location, for example Berlin, and language, for example Rust, and sort by followers. Each developer comes back with username, name, bio, location and follower and repository counts.

Can I use GitHub search for technical recruiting?

Yes. Search by language and location, then open promising profiles with the GitHub Profile and Contributions APIs to see their pinned work and activity.

Can I search only organizations?

Yes. Set type to org.

How do I get more than 10 results from a GitHub user search?

Each call returns up to 10 users and a nextCursor. Send it back as cursor to get the next page; it is null when there are no more.

How do I use the GitHub User Search API?

Send a POST request to https://api.bridgly.app/github/search-users with the filters you want in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.github.searchUsers(). AI agents connected to Bridgly over MCP can call the github_search_users tool.

How much does the GitHub User Search API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More GitHub endpoints

The same API key works on every endpoint. See all GitHub API endpoints.

Try the GitHub User Search API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs