Search Hugging Face Spaces
Search Hugging Face Spaces by keyword, SDK and tags.
Headers
Get your API keyAPI key (`sfk_...`)
Search text. Matches repository ids, tags and card text.
min 1 chars · max 200 chars
Only repositories owned by this user or organization.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
Only Spaces built with this SDK.
one of: gradio, streamlit, docker, static
Comma-separated tags the repository must all have, e.g. `text-classification,pytorch` or `license:mit`.
min 1 chars · max 400 chars · pattern: ^[A-Za-z0-9_.:/+-]+(,[A-Za-z0-9_.:/+-]+)*$
Sort order: `downloads` (last 30 days), `likes`, `likes7d`, `likes30d`, `trending`, `created` or `updated`. Default: `trending`.
one of: downloads, likes, likes7d, likes30d, trending, created, updated
`desc` (default) or `asc`. `asc` only works with `sort=created`.
one of: asc, desc
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/spaces?query=gradio&limit=5" \
-H "x-api-key: YOUR_API_KEY"Responses
Space search page.