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

---

# Hugging Face Collection API

One curated list with every item in order, including the curator's notes and each item's position.

`GET /v1/hugging-face/collections/{owner}/{slug}` returns `collection` with `slug`, `url`, `title`, `description`, `owner`, `upvotes`, `lastUpdatedAt`, `gated`, `theme`, `itemCount` and `items`. Unlike the search endpoint, `items` is the whole collection in order.

Each item has `type` (`model`, `dataset`, `space`, `paper` or `collection`), `id`, `url`, `note`, `position`, `title`, `repo`, `upvotes` and `publishedAt` where they apply. `slug` is the part after the owner, for example `gemma-4-69ce8ad93186d46744cb42f1`.

## Request

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

## FAQ

### How do I get the collection slug?

The collection's URL ends in owner/slug. This endpoint takes the owner and the slug separately, without the owner prefix in slug.

### What are notes and positions?

note is the curator's comment on an item, and position is its zero-based place in the list.

### Can a collection contain another collection?

Yes. An item with type collection points at another collection slug.

### How much does a collection lookup 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.