> **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/collections>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hugging-face/collections.mdx>

---

# Hugging Face Collections API

Curated lists of models, datasets, Spaces and papers, with the first items and the curator.

`GET /v1/hugging-face/collections` returns a page of `collections` and a `page` block. Use `query`, `owner`, `item` (for example `models/openai-community/gpt2` or `papers/1706.03762`), `sort` (`trending`, `upvotes`, `lastModified`), `limit` and `cursor`.

Each collection has `slug`, `url`, `title`, `description`, `owner`, `upvotes`, `lastUpdatedAt`, `gated`, `theme`, `itemCount` and `items`, the first items with their type, id, note, position, title and repository summary. This list carries a preview of up to 4 items and no total, so `itemCount` is null here; the single collection endpoint returns every item and the count. Follow `page.nextCursor` for more collections.

## Request

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

## FAQ

### How do I find collections that contain one model?

Pass item=models/owner/name. For a paper use item=papers/arxivId. The value must name the kind and the id.

### Are all items returned here?

No. This endpoint returns the first items of each collection. The collection endpoint returns every item in order.

### What can I sort by?

trending (default), upvotes or lastModified.

### How much does a collection search 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. Each paginated page is a separate billed request.