> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/hugging-face/trending>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hugging-face/trending.mdx>

---

# Hugging Face Trending API

What is trending on the platform right now, with the repository fields you use everywhere else.

`GET /v1/hugging-face/trending` returns up to `limit` repositories trending now, most trending first within each kind. Set `type` to `all` (default), `model`, `dataset` or `space`, and `limit` from 1 to 20.

Each row has `id`, `type`, `url`, `author`, `likes`, `downloads`, `downloadsAllTime`, `trendingScore`, `tags`, `license` and the kind's fields such as `pipelineTag` or `sdk`. The list is global, so no filter can make it empty.

## Request

- **Endpoint:** `GET /v1/hugging-face/trending`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by type
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/hugging-face/trending/get)
- **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face)

## FAQ

### How often does the trending list change?

The platform recalculates it continuously. The endpoint returns the current ranking, so poll it on your own schedule.

### Can I get only trending datasets?

Yes. Set type=dataset. model and space narrow it the same way.

### How many trending repositories can I get?

limit accepts 1 to 20 and caps the whole list, including type=all, so it is a short snapshot rather than a full catalogue.

### How much does a trending page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
