# GitHub Repository Scraper β Search Repos by Topic & Stars (`haketa/github-repository-scraper`) Actor
Search GitHub repositories by topic, programming language, keyword and stars. Export each with description, stars, forks, language, topics, license and homepage β plus the owner's company, location and website. Build repo datasets and developer leads, no token required.
- **URL**: https://apify.com/haketa/github-repository-scraper.md
- **Developed by:** [Haketa](https://apify.com/haketa) (community)
- **Categories:** Developer tools, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
π¦ GitHub Repository Scraper
Search GitHub repositories by topic, language and stars β with the owner behind each one.
    
Find exactly the repositories you care about β by **topic**, **programming language**, **keyword** and **star count** β and export each with its **description, stars, forks, language, topics, license and homepage**, plus the **owner's name, company, location and website**. It's both a clean repository dataset **and** a developer lead list in one run.
> π **No token, no login, no code.** Pick your filters and press **Start**. A GitHub token is optional and only speeds up very large jobs.
---
### β¨ Why you'll love it
- π― **Precisely targeted** β combine topic + language + star filters to get exactly the repositories you want.
- π¦ **Rich repository data** β stars, forks, watchers, open issues, language, topics, license, homepage and dates.
- π§βπ» **Owner leads included** β company, location, website and X/Twitter for every repository owner.
- π **Ranked** β sort by most stars, most forks or recently updated.
- π **Works without a token** β no API keys to manage.
- π§Ή **Clean, deduplicated output** β spreadsheet-ready.
---
### π₯ Who it's for
| You are⦠| Use it to⦠|
| :-- | :-- |
| π **Market / trend researcher** | Track the top projects in a topic or language and how they grow. |
| π οΈ **Dev-tool / SaaS marketer** | Find active projects and the developers behind them in your niche. |
| 𧲠**Technical recruiter** | Discover maintainers of notable repositories to reach out to. |
| π **Founder / investor** | Spot rising open-source projects and their owners. |
| π€ **Partnerships / BD** | Find projects and companies to integrate or collaborate with. |
---
### β‘ Quick start
1. Open the Actor.
2. Set any combination of filters β e.g. **Topic** = `machine-learning`, **Language** = `Python`, **Minimum stars** = `500`.
3. Press **Start**. (Leave everything empty for a sample of the most-starred repositories.)
4. Open the **Output** tab to preview.
5. Hit **Export** β **Excel / CSV / JSON**, or send to **Google Sheets**, **Airtable**, **Zapier**, **Make**, or your app via API.
---
### 𧩠Input options (all optional)
#### π€ Keyword Β· `keyword`
Words to match in a repository's name, description or README β e.g. `payment gateway`, `chatbot`, `kubernetes operator`.
#### π·οΈ Topic Β· `topic`
A GitHub topic tag β e.g. `machine-learning`, `nextjs`, `fintech`.
#### π» Programming language Β· `language`
Pick a language to only return repositories whose main language matches.
#### β Minimum stars Β· `minStars` Β· π΄ Minimum forks Β· `minForks`
Quality filters β only repositories above your thresholds.
#### βοΈ Sort by Β· `sort`
**Most stars**, **Most forks**, or **Recently updated**.
#### π§βπ» Enrich owner profiles Β· `enrichOwners`
On by default. Adds each owner's name, company, location, website, public email and X/Twitter β turning repositories into developer leads.
#### π’ Max repositories Β· `maxItems`
How many to collect. GitHub search returns up to **1,000** matches per set of filters.
#### π GitHub token Β· `githubToken` *(optional)* Β· π Proxy Β· `proxyConfiguration`
The token is optional (speeds up large jobs). Proxy is recommended and on by default.
---
### π§ͺ Example inputs
π€ Popular machine-learning projects in Python
```json
{ "topic": "machine-learning", "language": "Python", "minStars": 500, "maxItems": 200 }
````
π³ Fintech repositories, most forks first
```json
{ "topic": "fintech", "sort": "forks", "maxItems": 200 }
```
π Keyword search β chatbot projects with traction
```json
{ "keyword": "chatbot", "minStars": 100, "maxItems": 300 }
```
π The most-starred repositories on GitHub
```json
{ "maxItems": 100 }
```
***
### π€ Output
Every repository is one flat, spreadsheet-ready row, including the owner. Only the fields that exist are included, so your export stays clean.
#### π Field reference
| Field | π Description |
| :-- | :-- |
| `repoFullName` | π¦ `owner/repo`. |
| `description` | Repository description. |
| `repoUrl` | π Repository URL. |
| `homepage` | π The project's website, if set. |
| `stars` | β Star count. |
| `forks` | π΄ Fork count. |
| `watchers` | π Watcher count. |
| `openIssues` | Open issues count. |
| `language` | π» Main language. |
| `topics` | π·οΈ Topic tags. |
| `license` | π License (e.g. `MIT`). |
| `createdAt` / `updatedAt` / `pushedAt` | π Key dates. |
| `archived` | Whether the repository is archived. |
| `ownerUsername` | π§βπ» Owner's username. |
| `ownerType` | `User` or `Organization`. |
| `ownerName` | Owner's name. |
| `ownerCompany` | π’ Owner's company. |
| `ownerLocation` | π Owner's location. |
| `ownerWebsite` | π Owner's website. |
| `ownerEmail` | βοΈ Owner's public email, when available. |
| `ownerTwitter` | π¦ Owner's X / Twitter. |
| `ownerFollowers` | π₯ Owner's follower count. |
| `ownerProfileUrl` | π Owner's GitHub profile. |
#### π¦ Sample row
```json
{
"repoFullName": "huggingface/transformers",
"description": "State-of-the-art Machine Learning for PyTorch, TensorFlow and JAX.",
"repoUrl": "https://github.com/huggingface/transformers",
"homepage": "https://huggingface.co/transformers",
"stars": 132000,
"forks": 26000,
"language": "Python",
"topics": "machine-learning, nlp, pytorch, transformers",
"license": "Apache-2.0",
"ownerUsername": "huggingface",
"ownerType": "Organization",
"ownerName": "Hugging Face",
"ownerLocation": "NYC + Paris",
"ownerWebsite": "https://huggingface.co",
"ownerProfileUrl": "https://github.com/huggingface"
}
```
***
### π‘ Use cases in detail
**π Track a technology's top projects**
Filter by topic and language, sort by stars, and export a ranked snapshot of the leaders in a space β re-run on a schedule to watch it change.
**𧲠Find maintainers to recruit or sell to**
Every repository comes with its owner's company, location and website β turn a topic search into a targeted outreach list.
**π Spot rising projects**
Sort by recently updated with a star floor to find active, growing repositories early.
**π€ Build an integration target list**
Find the projects and companies building in your category for partnerships and integrations.
***
### π§ Tips for best results
- π― **Combine topic + language + stars** for the most focused, highest-quality list.
- π **Vary your filters** β GitHub returns up to 1,000 matches per filter set, so run several targeted searches to go wider.
- π§βπ» **Keep owner enrichment on** to get the lead data (company, location, website).
- π§Ή **Deduplication is automatic** within each run.
***
### π Export & integrations
β¬οΈ **Excel Β· CSV Β· JSON Β· XML** Β· π **Google Sheets & Airtable** Β· π **Webhooks & API** Β· π€ **Make, Zapier, n8n**
***
### β FAQ
**Do I need a token?** β No. The Actor runs fully without one. A token is optional and only speeds up very large jobs.
**Do I need to write a search query?** β No. Just fill in the friendly filters and the Actor builds the search for you.
**How many repositories can I get?** β GitHub search returns up to 1,000 matches per set of filters. Run several targeted searches (by topic, language, star range) to cover more.
**Are owner emails always included?** β Only when an owner has made their email public. Website, company and location are more commonly available.
**Will I get duplicates?** β No. Repositories are deduplicated within each run.
**Can I schedule it?** β Yes. Use Apify Schedules to refresh your lists daily, weekly or monthly.
***
### βοΈ Legal & responsible use
This Actor collects only publicly available information for legitimate research, recruiting and lead generation. You are responsible for how you use the data, including compliance with applicable laws (such as GDPR and CCPA), platform terms, and anti-spam rules when contacting anyone. Do not use the data for unsolicited bulk messaging or any unlawful purpose, and always respect the privacy and preferences of the people and businesses in your results.
# Actor input Schema
## `keyword` (type: `string`):
Optional. Words to match in a repository's name, description or README β e.g. "payment gateway", "chatbot", "kubernetes operator". Leave empty to search by the filters below only.
## `topic` (type: `string`):
Optional. A GitHub topic tag β e.g. "machine-learning", "nextjs", "fintech". Leave empty for any topic.
## `language` (type: `string`):
Optional. Only repositories whose main language matches. Leave empty for any language.
## `minStars` (type: `integer`):
Optional. Only repositories with at least this many stars. Set 0 for no minimum.
## `minForks` (type: `integer`):
Optional. Only repositories with at least this many forks. Set 0 for no minimum.
## `sort` (type: `string`):
How to order the results.
## `enrichOwners` (type: `boolean`):
Add each owner's name, company, location, website, public email and X/Twitter β great for turning repositories into developer leads. Turn off for a faster repositories-only list.
## `maxItems` (type: `integer`):
How many repositories to collect. GitHub search returns up to 1,000 matches per set of filters. Set 0 for the maximum.
## `githubToken` (type: `string`):
Optional. The Actor works without one. Add a free GitHub personal access token to run large jobs faster (GitHub β Settings β Developer settings β Personal access tokens; no special scopes needed).
## `proxyConfiguration` (type: `object`):
Recommended for reliable collection. Datacenter proxies are enough for this Actor.
## Actor input object example
```json
{
"keyword": "chatbot",
"topic": "machine-learning",
"language": "",
"minStars": 0,
"minForks": 0,
"sort": "stars",
"enrichOwners": true,
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `dataset` (type: `string`):
Open to view, filter and export all collected dependents and their owners (JSON, CSV, Excel).
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("haketa/github-repository-scraper").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 100,
"proxyConfiguration": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("haketa/github-repository-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("πΎ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# π Want to learn more π? Go to β https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 100,
"proxyConfiguration": {
"useApifyProxy": true
}
}' |
apify call haketa/github-repository-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=haketa/github-repository-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "GitHub Repository Scraper β Search Repos by Topic & Stars",
"description": "Search GitHub repositories by topic, programming language, keyword and stars. Export each with description, stars, forks, language, topics, license and homepage β plus the owner's company, location and website. Build repo datasets and developer leads, no token required.",
"version": "0.1",
"x-build-id": "0z5IGnUm1PUIZl7Iw"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/haketa~github-repository-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-haketa-github-repository-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/haketa~github-repository-scraper/runs": {
"post": {
"operationId": "runs-sync-haketa-github-repository-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/haketa~github-repository-scraper/run-sync": {
"post": {
"operationId": "run-sync-haketa-github-repository-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"keyword": {
"title": "Keyword",
"type": "string",
"description": "Optional. Words to match in a repository's name, description or README β e.g. \"payment gateway\", \"chatbot\", \"kubernetes operator\". Leave empty to search by the filters below only."
},
"topic": {
"title": "Topic",
"type": "string",
"description": "Optional. A GitHub topic tag β e.g. \"machine-learning\", \"nextjs\", \"fintech\". Leave empty for any topic."
},
"language": {
"title": "Programming language",
"enum": [
"",
"JavaScript",
"TypeScript",
"Python",
"Java",
"Go",
"Rust",
"C",
"C++",
"C#",
"Ruby",
"PHP",
"Swift",
"Kotlin",
"Scala",
"Dart",
"Elixir",
"Shell",
"HTML",
"Jupyter Notebook"
],
"type": "string",
"description": "Optional. Only repositories whose main language matches. Leave empty for any language.",
"default": ""
},
"minStars": {
"title": "Minimum stars",
"minimum": 0,
"type": "integer",
"description": "Optional. Only repositories with at least this many stars. Set 0 for no minimum.",
"default": 0
},
"minForks": {
"title": "Minimum forks",
"minimum": 0,
"type": "integer",
"description": "Optional. Only repositories with at least this many forks. Set 0 for no minimum.",
"default": 0
},
"sort": {
"title": "Sort by",
"enum": [
"stars",
"forks",
"updated"
],
"type": "string",
"description": "How to order the results.",
"default": "stars"
},
"enrichOwners": {
"title": "Enrich owner profiles",
"type": "boolean",
"description": "Add each owner's name, company, location, website, public email and X/Twitter β great for turning repositories into developer leads. Turn off for a faster repositories-only list.",
"default": true
},
"maxItems": {
"title": "Max repositories",
"minimum": 0,
"type": "integer",
"description": "How many repositories to collect. GitHub search returns up to 1,000 matches per set of filters. Set 0 for the maximum.",
"default": 100
},
"githubToken": {
"title": "GitHub token (optional)",
"type": "string",
"description": "Optional. The Actor works without one. Add a free GitHub personal access token to run large jobs faster (GitHub β Settings β Developer settings β Personal access tokens; no special scopes needed)."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Recommended for reliable collection. Datacenter proxies are enough for this Actor.",
"default": {
"useApifyProxy": true
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```