Hugging Face API: List trending models
Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.
Unofficial. Not affiliated with or endorsed by Hugging Face.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Task optional
task Task in plain words, such as text generation, speech recognition, or image classification. Leave blank for all tasks.
(default)
- Max Results optional
max_results Maximum number of trending models to return, such as 20 (up to 100).
100
Whole number from 1 to 100. Default
20.
Input as JSON
{ "max_results": 100}Output
{ "models": [ { "rank": 1, "task": "image text to text", "likes": 2436, "model_name": "DeepSeek-V4.1-Flash-1017", "repository_id": "deepseek-ai/DeepSeek-V4.1-Flash-1017" , "trending_score": 2097, "model_page_link": "https://huggingface.co/deepseek-ai/DeepSeek-V4.1-Flash-1017" , "last_updated_date": "2026-10-17", "author_or_organization": "deepseek-ai", "downloads_last_30_days": 51911 }, { "rank": 2, "task": "image to image", "likes": 1328, "model_name": "flux-3-image-klein-comfy", "repository_id": "black-forest-labs/flux-3-image-klein-comfy" , "trending_score": 715, "model_page_link": "https://huggingface.co/black-forest-labs/flux-3-image-klein-comfy" , "last_updated_date": "2026-10-17", "author_or_organization": "black-forest-labs", "downloads_last_30_days": 512524 }, { "rank": 3, "task": "text generation", "likes": 592, "model_name": "flint", "repository_id": "RecursiveSI/flint" , "trending_score": 581, "model_page_link": "https://huggingface.co/RecursiveSI/flint" , "last_updated_date": "2026-10-21", "author_or_organization": "RecursiveSI", "downloads_last_30_days": 420 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"huggingface.co/list_trending_models","input":{"max_results":100}}' # 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": "huggingface.co/list_trending_models" , "input": { "max_results": 100 }})# 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": "huggingface.co/list_trending_models" , "input": { "max_results": 100 } }), 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 huggingface.co/list_trending_models# with {"max_results":100}"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": { "task": { "type": "string", "default": "", "description": "Task in plain words, such as text generation, speech recognition, or image classification. Leave blank for all tasks." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of trending models to return, such as 20 (up to 100)." } }}Output schema
{ "type": "object", "required": [ "models" ], "properties": { "models": { "type": "array", "items": { "type": "object", "required": [ "rank", "model_name", "author_or_organization", "task", "downloads_last_30_days", "likes", "last_updated_date", "model_page_link", "repository_id", "trending_score" ], "properties": { "rank": { "type": "integer", "description": "Position in the trending list." }, "task": { "type": [ "string", "null" ], "description": "Task in plain words, if listed." }, "likes": { "type": [ "integer", "null" ], "description": "Number of likes." }, "model_name": { "type": "string", "description": "Model name." }, "repository_id": { "type": "string", "description": "Full repository name in author/name format." }, "trending_score": { "type": [ "integer", "null" ], "description": "Hugging Face trending score." }, "model_page_link": { "type": "string", "format": "uri", "description": "Model page link." }, "last_updated_date": { "type": [ "string", "null" ], "format": "date", "description": "Last updated date." }, "author_or_organization": { "type": [ "string", "null" ], "description": "Publishing author or organization." }, "downloads_last_30_days": { "type": [ "integer", "null" ], "description": "Downloads in the last 30 days." } }, "additionalProperties": false }, "description": "Models ordered by trending rank." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
huggingface.co/list_trending_models- Returns
- rank, model name, author, task, downloads, likes, last updated date, page link, repository id, trending score
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 huggingface.co/list_trending_models with the inputs above.
Ask your agent
- What are the top 15 trending models this week for image classification on Hugging Face?
- Show me the most popular text generation models trending right now, with their download counts and likes.
- Which speech recognition models are gaining the most traction this week on huggingface.co?
- I need a list of 50 trending models across all tasks, including authors and last updated dates.
- Find the current trending models for summarization, ranked, and give me their repository ids and trending scores.
See more
All Hugging Face methodsFinds public Hugging Face models by search words, with an optional task and sort order. License is null when the model does not publish one.
huggingface.co/search_modelsFinds public Hugging Face datasets by name or topic, ordered by downloads, likes, trending score or last update.
huggingface.co/search_datasetsLooks up one Hugging Face model by name, repository ID or link and returns its public details, model card summary and file sizes. For a name, the first matching model is returned.
huggingface.co/get_modelFinds public Hugging Face Spaces demos for a task, with descriptions, likes, running status and update dates.
huggingface.co/search_spacesLists 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 popular or trending WEBTOON series in ranking order, with authors and displayed subscriber and view counts. Genre filtering keeps matching series from the public top 30.
webtoons.com/list_rankingsLists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period.
github.com/list_trending_repositoriesLists 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