Get Hugging Face collection
Get a Hugging Face collection with every item and the curator's notes.
Headers
Get your API keyAPI key (`sfk_...`)
Owner of the collection: a user or organization name.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
Collection slug without the owner, e.g. `gemma-4-69ce8ad93186d46744cb42f1`.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,150}$
Endpoint-specific response payload.
Whether the item was found.
one of: found, not_found
The collection when lookupStatus is `found`; otherwise null.
Collection slug, `owner/title-id`.
Collection page URL.
Title.
Description.
Who curates the collection.
Account name, the part of the profile URL after the domain.
Stable account id.
Display name.
Avatar image URL.
Profile page URL.
Whether the account is a user or an organization.
one of: user, org, null
Whether the account has a Pro subscription.
Whether the account belongs to the platform's staff, when the response includes it.
Followers, when the response includes it.
Upvotes.
When the collection last changed (ISO-8601).
Whether the collection is gated.
Colour theme of the collection.
Items in the collection. Lists carry a preview of up to 4 `items` and no total, so `itemCount` is null there; the detail route returns every item and the count.
Every item, in order.
Item kind: `model`, `dataset`, `space`, `paper` or `collection`.
Item id: a repository id, a paper id or a collection slug.
Item page URL.
The curator's note on the item.
Position in the collection, from 0.
Title of a paper or collection.
Repository details when the item is a model, dataset or Space.
Repository id, `owner/name`.
Repository type.
one of: model, dataset, space
Stable repository id; survives renames.
Repository page URL.
Owner account name.
When the repository was created (ISO-8601).
When the repository last changed (ISO-8601).
Latest commit on the default branch.
Likes.
Downloads in the last 30 days.
Downloads since the repository was created.
Trending score.
Whether access needs approval: `false`, `auto` (accepted on request) or `manual` (reviewed by the owner).
Whether the repository has been disabled.
Tags: task, library, languages, licence and more. Null when the collection item does not carry them.
Main task of a model, e.g. `text-generation`; null in dataset and Space results.
Library a model is made for, e.g. `transformers`; null in dataset and Space results.
Licence id taken from the tags, e.g. `mit`.
SDK of a Space, e.g. `gradio`; null in model and dataset results.
Parameter count of a model, when known; null in dataset and Space results.
Run state of a Space, e.g. `RUNNING` or `SLEEPING`; null in model and dataset results.
Upvotes on a paper or collection.
When a paper was published (ISO-8601).
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/hugging-face/collections/google/gemma-4-69ce8ad93186d46744cb42f1" \
-H "x-api-key: YOUR_API_KEY"Responses
Collection details.