# 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. - Page: https://fous.com/methods/huggingface.co/list-trending-models - Method: `huggingface.co/list_trending_models`, version 1 - Website: huggingface.co - Returns: rank, model name, author, task, downloads, likes, last updated date, page link, repository id, trending score - 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 | |---|---|---|---|---| | `task` | string | no | | Task in plain words, such as text generation, speech recognition, or image classification. Leave blank for all tasks. Default "". | | `max_results` | integer | no | `100` | Maximum number of trending models to return, such as 20 (up to 100). Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "max_results": 100 } ``` Its output: ```json { "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 } ] } ``` ## 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":"huggingface.co/list_trending_models","input":{"max_results":100}}' ``` 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 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. ## Input schema ```json { "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 ```json { "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 } ``` ## See more - [Hugging Face API: Search models](https://fous.com/methods/huggingface.co/search-models.md): Finds public Hugging Face models by search words, with an optional task and sort order. License is null when the model does not publish one. - [Hugging Face API: Search datasets](https://fous.com/methods/huggingface.co/search-datasets.md): Finds public Hugging Face datasets by name or topic, ordered by downloads, likes, trending score or last update. - [Hugging Face API: Get model details](https://fous.com/methods/huggingface.co/get-model.md): Looks 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. - [Hugging Face API: Search Hugging Face Spaces](https://fous.com/methods/huggingface.co/search-spaces.md): Finds public Hugging Face Spaces demos for a task, with descriptions, likes, running status and update dates. - [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. - [WEBTOON API: List rankings](https://fous.com/methods/webtoons.com/list-rankings.md): Lists 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. - [GitHub API: List trending repositories](https://fous.com/methods/github.com/list-trending-repositories.md): Lists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period. - [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 Hugging Face methods](https://fous.com/methods/huggingface.co.md)