Search Hugging Face collections
Search Hugging Face collections, or find the collections that contain a model, dataset, Space or paper.
Headers
Get your API keyAPI key (`sfk_...`)
Search text in titles and descriptions.
min 1 chars · max 200 chars
Only collections this account curates.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
Only collections that contain this item, e.g. `models/openai-community/gpt2` or `papers/1706.03762`.
pattern: ^(?:models|datasets|spaces)\/[A-Za-z0-9][A-Za-z0-9._-]{0,95}\/[A-Za-z0-9][A-Za-z0-9._-]{0,95}$|^papers\/[A-Za-z0-9./-]{1,40}$
`trending` (default), `upvotes` or `lastModified`.
one of: trending, upvotes, lastModified
Items per page, 1-100. A page can hold fewer. Default: 10.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. Keep every other parameter the same.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
Whether the item was found.
one of: found, not_found
Collections on this page.
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.
The first items of the collection.
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).
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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?query=gemma&limit=3" \
-H "x-api-key: YOUR_API_KEY"Responses
Collection page.