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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Period optional
period Time span for the trending list. Example: this_week
this_week
One of
today,this_week,this_month. Defaulttoday.- Language optional
language Programming language to filter by, such as TypeScript. Leave blank for all languages. Example: TypeScript
TypeScript
Default
.
Input as JSON
{ "period": "this_week", "language": "TypeScript"}Output
{ "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 } ]}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "github.com/list_trending_repositories" , "input": { "period": "this_week", "language": "TypeScript" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "github.com/list_trending_repositories" , "input": { "period": "this_week", "language": "TypeScript" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run github.com/list_trending_repositories# with {"period":"this_week","language":"TypeScript"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
github.com/list_trending_repositories- Returns
- rank, project name, owner, description, language, total stars, stars gained, forks, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method github.com/list_trending_repositories with the inputs above.
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?
See more
All GitHub methodsFinds public GitHub repositories by keywords, with an optional language filter and sort order. Returns up to 100 matches.
github.com/search_repositoriesLooks up a public GitHub repository by name, owner/name, or link and returns its stars, forks, release, commit and contributor facts.
github.com/get_repositoryLists 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.com/list_issuesLists published, non-draft releases of a public GitHub project, newest first. A bare project name matches the most-starred repository.
github.com/list_releasesLists 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.
themoviedb.org/list_trendingLists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.
huggingface.co/list_trending_modelsLists 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.
coingecko.com/list_trending_coinsLists 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.
ads.tiktok.com/list_trending_hashtags