# GitHub Trending Scraper — Repos & Developers (`openclawmara/github-trending-scraper`) Actor

Scrape GitHub Trending repositories and developers. Extract repo names, descriptions, stars, forks, language, and daily/weekly/monthly trends. Discover rising open source projects and active contributors. Essential for tech scouting and OSS research.

- **URL**: https://apify.com/openclawmara/github-trending-scraper.md
- **Developed by:** [OpenClaw Mara](https://apify.com/openclawmara) (community)
- **Categories:** Developer tools
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 1,000 repo scrapeds

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Trending Scraper

Scrape trending repositories and developers from [GitHub Trending](https://github.com/trending). Get real-time data on what's hot in the developer community — filterable by language, time range, and spoken language.

### What can it do?

- **Trending repositories** — Top repos by stars gained in a time period
- **Trending developers** — Most active developers with their popular repos
- **Filter by language** — Python, JavaScript, Rust, Go, or any of 500+ languages
- **Time ranges** — Daily, weekly, or monthly trends
- **Spoken language** — Filter by content language (English, Chinese, etc.)

### Why use this scraper?

- ⚡ **Fast** — Direct HTML parsing, no API token needed
- 📊 **Rich data** — Stars, forks, language, description, stars gained today
- 👨‍💻 **Developer profiles** — Username, popular repo, avatar
- 🔄 **Always current** — GitHub Trending updates in real-time
- 🌍 **Multi-language** — Filter by programming and spoken language

### Input examples

#### Get all trending repos today

```json
{
  "mode": "repositories",
  "since": "daily"
}
```

#### Trending Python repos this week

```json
{
  "mode": "repositories",
  "language": "python",
  "since": "weekly"
}
```

#### Trending developers this month

```json
{
  "mode": "developers",
  "since": "monthly"
}
```

#### Trending Rust repos

```json
{
  "mode": "repositories",
  "language": "rust",
  "since": "daily"
}
```

### Output example (repository)

```json
{
  "rank": 1,
  "username": "openai",
  "reponame": "codex",
  "url": "https://github.com/openai/codex",
  "description": "Lightweight coding agent that runs in your terminal",
  "language": "TypeScript",
  "stars": 15200,
  "forks": 1100,
  "starsToday": 2300,
  "builtBy": ["developer1", "developer2"]
}
```

### Use cases

- **Open source intelligence** — Track new popular projects early
- **Technology radar** — Monitor which languages/frameworks are gaining traction
- **Hiring research** — Find active developers in specific technologies
- **Investment signals** — Spot trending developer tools and infrastructure
- **Content creation** — Write about what's trending in tech

### Pricing

Free to use. You only pay for Apify platform usage (compute and storage).

### Limitations

- GitHub Trending shows ~25 repos per page
- Trending data is based on recent star activity (not total stars)
- HTML scraping — may need updates if GitHub changes their page layout

# Actor input Schema

## `mode` (type: `string`):

What to scrape from GitHub Trending

## `language` (type: `string`):

Filter by programming language (leave empty for all). Examples: python, javascript, rust, go, typescript

## `since` (type: `string`):

Time range for trending calculation

## `spokenLanguage` (type: `string`):

Filter by spoken language code (e.g., 'en' for English, 'zh' for Chinese). Leave empty for all.

## Actor input object example

```json
{
  "mode": "repositories",
  "since": "daily"
}
```

# 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 = {
    "mode": "repositories",
    "since": "daily"
};

// Run the Actor and wait for it to finish
const run = await client.actor("openclawmara/github-trending-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "repositories",
    "since": "daily",
}

# Run the Actor and wait for it to finish
run = client.actor("openclawmara/github-trending-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 '{
  "mode": "repositories",
  "since": "daily"
}' |
apify call openclawmara/github-trending-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=openclawmara/github-trending-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/JhKvzDP1644f6gOmB/builds/eiyHXv9pmLP63XOAi/openapi.json