# GitHub API: List trending repositories

> Lists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period.

Unofficial. Not affiliated with or endorsed by GitHub.

- Page: https://fous.com/methods/github.com/list-trending-repositories
- Method: `github.com/list_trending_repositories`, version 1
- Website: github.com
- Returns: rank, project name, owner, description, language, total stars, stars gained, forks, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `period` | string | no | `"this_week"` | Time span for the trending list. Example: this_week One of "today", "this_week", "this_month". Default "today". |
| `language` | string | no | `"TypeScript"` | Programming language to filter by, such as TypeScript. Leave blank for all languages. Example: TypeScript Default "". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "period": "this_week",
  "language": "TypeScript"
}
```

Its output:

```json
{
  "repositories": [
    {
      "rank": 1,
      "forks": 92360,
      "owner": "morluto",
      "language": "TypeScript",
      "description": "Reverse engineer anything with agents, from app behavior down to native binaries.",
      "total_stars": 368667,
      "project_link": "https://github.com/morluto/rea",
      "project_name": "rea",
      "stars_gained": 106341
    },
    {
      "rank": 2,
      "forks": 9239,
      "owner": "ruvnet",
      "language": "TypeScript",
      "description": "🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated",
      "total_stars": 78578,
      "project_link": "https://github.com/ruvnet/ruflo",
      "project_name": "ruflo",
      "stars_gained": 3708
    },
    {
      "rank": 3,
      "forks": 29461,
      "owner": "anomalyco",
      "language": "TypeScript",
      "description": "The open source coding agent.",
      "total_stars": 220341,
      "project_link": "https://github.com/anomalyco/opencode",
      "project_name": "opencode",
      "stars_gained": 6750
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"github.com/list_trending_repositories","input":{"period":"this_week","language":"TypeScript"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What repositories are trending on GitHub this week in Rust?
- Show me the top trending projects today with their star counts and forks
- Which Python libraries gained the most stars this month on GitHub?
- I need a list of the hottest open source projects trending right now across all languages, with descriptions and links
- What TypeScript repos are climbing the charts today?

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "period": {
      "enum": [
        "today",
        "this_week",
        "this_month"
      ],
      "type": "string",
      "default": "today",
      "description": "Time span for the trending list. Example: this_week"
    },
    "language": {
      "type": "string",
      "default": "",
      "description": "Programming language to filter by, such as TypeScript. Leave blank for all languages. Example: TypeScript"
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "repositories"
  ],
  "properties": {
    "repositories": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "project_name",
          "owner",
          "description",
          "language",
          "total_stars",
          "stars_gained",
          "forks",
          "project_link"
        ],
        "properties": {
          "rank": {
            "type": "integer",
            "description": "Position on the trending page."
          },
          "forks": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Total repository forks, if shown."
          },
          "owner": {
            "type": "string",
            "description": "Repository owner."
          },
          "language": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary programming language, if shown."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Repository description, if present."
          },
          "total_stars": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Total repository stars, if shown."
          },
          "project_link": {
            "type": "string",
            "description": "Link to the repository."
          },
          "project_name": {
            "type": "string",
            "description": "Repository name."
          },
          "stars_gained": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Stars gained during the selected period, if shown."
          }
        },
        "additionalProperties": false
      },
      "description": "Trending repositories in page order, up to 25."
    }
  },
  "additionalProperties": false
}
```

## See more

- [GitHub API: Search repositories](https://fous.com/methods/github.com/search-repositories.md): Finds public GitHub repositories by keywords, with an optional language filter and sort order. Returns up to 100 matches.
- [GitHub API: Get repository facts](https://fous.com/methods/github.com/get-repository.md): Looks up a public GitHub repository by name, owner/name, or link and returns its stars, forks, release, commit and contributor facts.
- [GitHub API: List issues or pull requests](https://fous.com/methods/github.com/list-issues.md): Lists public issues or pull requests for a GitHub project, with state, label and sort options. A bare project name matches the most-starred repository with that name.
- [GitHub API: List releases](https://fous.com/methods/github.com/list-releases.md): Lists published, non-draft releases of a public GitHub project, newest first. A bare project name matches the most-starred repository.
- [themoviedb.org API: List trending movies and TV shows](https://fous.com/methods/themoviedb.org/list-trending.md): Lists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those.
- [Hugging Face API: List trending models](https://fous.com/methods/huggingface.co/list-trending-models.md): Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.
- [CoinGecko API: List trending coins](https://fous.com/methods/coingecko.com/list-trending-coins.md): Lists up to 15 of the most-searched coins on CoinGecko in trending order, with price and 24-hour change in the chosen currency. Non-USD prices may be unavailable for some coins.
- [TikTok API: List trending hashtags](https://fous.com/methods/ads.tiktok.com/list-trending-hashtags.md): Lists publicly visible TikTok Creative Center trending hashtags by country, time period and industry. Anonymous visitors see at most three rows; rank change and new-entry status are not public and come back null.
- [All GitHub methods](https://fous.com/methods/github.com.md)
