# GitHub Users Scraper (`automly/github-users-search-api`) Actor

Find GitHub users and organizations by keyword, location, company, followers and repository count: username, profile link, avatar and type. Export to CSV, JSON or Excel, schedule runs or use the API.

- **URL**: https://apify.com/automly/github-users-search-api.md
- **Developed by:** [Automly](https://apify.com/automly) (community)
- **Categories:** Developer tools, Lead generation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.50 / 1,000 result item produceds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## GitHub Users Scraper - Developers by Location & Company

### What is GitHub Users Scraper?

**GitHub Users Scraper** is a tool that lets you **scrape GitHub users and organizations from GitHub search** by keyword, location, company, follower count and repository count: username, profile link, avatar, account type and GitHub ID for every match. Type a keyword such as `python`, add a location like `Berlin`, click **Start**, and download the profiles as Excel, CSV or JSON.

- 📍 **Filters:** location, company, minimum followers, minimum public repositories and account type
- ↕️ **Sorting:** best match, most followers, most repositories or join date
- 🔓 **No login:** no GitHub account or key needed
- 💸 **Free to try:** the $5 of free usage every Apify account gets each month covers about 10,000 profiles

### What can GitHub Users Scraper do?

- Find GitHub users by keyword in their username, name or email
- Find developers on GitHub by location, such as Berlin, San Francisco or India
- Find GitHub users by company, such as Microsoft or Apify
- Find GitHub users with more than 100 followers
- Find GitHub organizations by keyword and location
- Sort GitHub users by followers, repositories or join date
- Get up to 100 profiles per run
- Export GitHub user lists to Excel, CSV, JSON, HTML or XML

### What data can you extract from GitHub users?

| | | |
|---|---|---|
| 👤 Username (`login`) | 🔗 Profile link | 🖼️ Avatar image |
| 🏢 Account type (user or organization) | 🆔 GitHub user ID | 🎯 Match score |
| 📍 The location filter you used | 🏭 The company filter you used | 🔎 Your search query |

### How to scrape GitHub users

1. [Create a free Apify account](https://console.apify.com/sign-up) (no credit card needed).
2. Open **GitHub Users Scraper**.
3. Type a **Query**, for example `python`.
4. Add filters (**Location**, **Company**, **Minimum followers**, **Minimum repositories**, **Account type**), choose **Sort** and **Order**, set **Max results** and click **Start**.
5. When the run finishes, open the **Profiles** view in the **Output** tab or download the profiles as Excel, CSV, JSON, HTML or XML.

### How much does it cost to scrape GitHub users?

You pay **$0.50 per 1,000 profiles**. Apify platform usage is included in this price, so there is nothing else to pay for the run.

For example, 1,000 profiles cost $0.50 on the Free plan, and a run that returns 100 profiles costs $0.05.

Every Apify account gets **$5 of free usage each month**. See the **Pricing** tab for details.

### ⬇️ Input

| Setting | What it does |
|---|---|
| Query | Words to match in usernames, names and emails, such as `python` or `data scientist` (required) |
| Max results | How many profiles to return (default 20, up to 100) |
| Sort | `best-match`, `followers`, `repositories` or `joined` |
| Order | `desc` or `asc` |
| Location | Only accounts whose profile location matches, such as `Tokyo` or `San Francisco` |
| Company | Only accounts whose profile company matches, such as `Microsoft` |
| Minimum followers | Only accounts with at least this many followers |
| Minimum repositories | Only accounts with at least this many public repositories |
| Account type | `user`, `org`, or empty for both |
| Your own GitHub key | Optional and not needed. Leave it empty; the actor works without it |

Example: Python developers in Berlin with 100+ followers, most followed first.

```json
{
  "query": "python",
  "location": "Berlin",
  "minFollowers": 100,
  "sort": "followers",
  "order": "desc",
  "maxResults": 50
}
```

Example: organizations about machine learning.

```json
{
  "query": "machine learning",
  "accountType": "org",
  "sort": "repositories",
  "maxResults": 100
}
```

### ⬆️ Output

You get one row per GitHub account. You can view the rows as a table in Apify Console (the **Profiles** view shows avatar, username, type and profile link) or download them as Excel, CSV, JSON, HTML or XML. Each row also repeats the query and filters that found it.

```json
{
  "recordType": "user_search_result",
  "query": "python",
  "location": "Berlin",
  "company": "",
  "minFollowers": 0,
  "minRepos": 0,
  "accountType": "User",
  "login": "tiangolo",
  "htmlUrl": "https://github.com/tiangolo",
  "avatarUrl": "https://avatars.githubusercontent.com/u/1326112?v=4",
  "apiUrl": "https://api.github.com/users/tiangolo",
  "nodeId": "MDQ6VXNlcjEzMjYxMTI=",
  "userId": 1326112,
  "score": 1,
  "userViewType": "public",
  "followersUrl": "https://api.github.com/users/tiangolo/followers",
  "subscriptionsUrl": "https://api.github.com/users/tiangolo/subscriptions",
  "organizationsUrl": "https://api.github.com/users/tiangolo/orgs",
  "reposUrl": "https://api.github.com/users/tiangolo/repos",
  "receivedEventsUrl": "https://api.github.com/users/tiangolo/received_events"
}
```

### How can I use GitHub user data?

- **Tech recruiting:** find developers in a city with a following, for example Python developers in Berlin with 100+ followers
- **Developer relations:** find active people around a language or technology to invite to events, betas or programs
- **Sales and partnerships:** list the organizations on GitHub in a market or region
- **Community research:** study developer communities by region or company
- **CRM enrichment:** add GitHub profile links and avatars to your CRM, applicant tracker or spreadsheet

### Scrape more GitHub and developer data

| Actor | What it gets |
|---|---|
| [GitHub Repository Scraper - Repos, Issues & Pull Requests](https://apify.com/automly/github-repo-scraper) | Repository details, open issues, pull requests and contributor profiles with company, location and public email |
| [GitHub Issues Scraper - Issues & Pull Requests Monitor](https://apify.com/automly/github-issues-pr-monitor) | New, updated, closed and merged issues and pull requests across repos, orgs and users |
| [GitHub Code Search API](https://apify.com/automly/github-code-search-api) | Public code files that match your search, with repository details |
| [Stack Overflow Scraper - Questions, Tags & Scores](https://apify.com/automly/stack-exchange-questions-api) | Stack Overflow and Stack Exchange questions with tags, scores and answer counts |
| [Website Email Scraper - Find Email Addresses in Bulk](https://apify.com/automly/website-email-scraper) | Email addresses from websites, such as the blogs and company sites on developer profiles |

### ❓FAQ

#### How much does GitHub Users Scraper cost?

$0.50 per 1,000 profiles, platform usage included. See the cost section above and the **Pricing** tab.

#### Do I need a GitHub account or key?

No. The actor works without a GitHub account, login or key.

#### How many profiles can I get per run?

Up to 100. For more, split your search into several runs, for example by location, company or follower range.

#### Why did I get fewer profiles than Max results?

Only that many accounts match the query and filters. Try a broader query or fewer filters.

#### Does it return email addresses, bios or follower counts?

No. It returns what GitHub's user search shows for each match: username, profile link, avatar, type and ID. The follower and repository filters are applied by GitHub during the search. For company, location, bio, follower counts and public emails of a project's contributors, use [GitHub Repository Scraper](https://apify.com/automly/github-repo-scraper).

#### Can I search organizations only?

Yes. Set **Account type** to `org`.

#### Is private data included?

No. Only public profiles that GitHub search shows to anyone.

#### Can I connect GitHub Users Scraper to other tools or AI agents?

Yes. Start runs and download results with the Apify API or the Python and JavaScript clients, send results to Make, Zapier, n8n, Google Sheets or Slack with Apify integrations and webhooks, or let AI assistants and agents run it through the Apify MCP server at [mcp.apify.com](https://mcp.apify.com).

#### Is it legal to scrape GitHub?

This actor only collects public profile data that GitHub search shows to anyone. Usernames and profile links are still personal data, which may be protected by laws such as GDPR, so only scrape them for a legitimate reason, such as recruiting with a lawful basis, and ask a lawyer if you are unsure. You can read more in [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

GitHub Users Scraper is an independent tool. It is not affiliated with, endorsed by or sponsored by GitHub.

#### Something isn't working?

Open the **Issues** tab and tell us your input and what you expected.

### ⭐ Your feedback

Have an idea or found a problem? Tell us on the **Issues** tab. If GitHub Users Scraper saved you time, a short review on the **Reviews** tab helps other people find it.

# Actor input Schema

## `query` (type: `string`):

Words to match in usernames, names and emails, such as 'python' or 'data scientist'. Combine with the filters below.

## `maxResults` (type: `integer`):

Maximum number of user records to return. Values above 100 are clamped.

## `sort` (type: `string`):

Search sort order. Use 'best-match', 'followers', 'repositories', or 'joined'.

## `order` (type: `string`):

Sort direction. Use 'desc' or 'asc'.

## `location` (type: `string`):

Optional GitHub location qualifier, such as 'Tokyo' or 'San Francisco'.

## `company` (type: `string`):

Optional GitHub company qualifier, such as 'Apify' or 'Microsoft'.

## `minFollowers` (type: `integer`):

Optional minimum follower count filter.

## `minRepos` (type: `integer`):

Optional minimum public repository count filter.

## `accountType` (type: `string`):

Optional account type filter. Use 'user' or 'org'.

## `token` (type: `string`):

Optional. Not needed: the actor works without a token. Add your own GitHub token if you prefer.

## Actor input object example

```json
{
  "query": "python",
  "maxResults": 20,
  "sort": "best-match",
  "order": "desc",
  "location": "Berlin",
  "company": "",
  "minFollowers": 0,
  "minRepos": 0,
  "accountType": ""
}
```

# Actor output Schema

## `results` (type: `string`):

Every profile with all fields.

## `overview` (type: `string`):

Matching users and organizations with avatar, username, type and profile link.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "python",
    "location": "Berlin"
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/github-users-search-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "python",
    "location": "Berlin",
}

# Run the Actor and wait for it to finish
run = client.actor("automly/github-users-search-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "python",
  "location": "Berlin"
}' |
apify call automly/github-users-search-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automly/github-users-search-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0a90auaqm6Yxp1Ldd/builds/vdVBiNNwk6AbcbRnz/openapi.json