List Hugging Face repositories
List the public models, datasets or Spaces of a Hugging Face account.
Headers
Get your API keyAPI key (`sfk_...`)
Hugging Face user or organization name, e.g. `clem`.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
`models` (default), `datasets` or `spaces`.
one of: models, datasets, spaces
Sort order: `downloads`, `likes`, `likes7d`, `likes30d`, `trending`, `created` or `updated`. Default: `updated`.
one of: downloads, likes, likes7d, likes30d, trending, created, updated
Items per page, 1-1000. A page can hold fewer. Default: 50.
≥ 1 · ≤ 1000
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
Repositories on this page.
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.
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.
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/accounts/huggingface/repos?limit=5" \
-H "x-api-key: YOUR_API_KEY"Responses
Repository page.