Get Hugging Face Space
Get a Hugging Face Space with its run state, hardware, SDK and linked models and datasets.
Headers
Get your API keyAPI key (`sfk_...`)
Owner of the repository: a user or organization name.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
Repository name, without the owner.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
Branch, tag or commit. Default: the default branch (`main`).
min 1 chars · max 200 chars · pattern: ^[A-Za-z0-9][A-Za-z0-9._/-]*$
Endpoint-specific response payload.
Whether the item was found.
one of: found, not_found
The Space when lookupStatus is `found`; otherwise null.
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.
Subdomain the Space's app is served from.
URL of the running app.
Region the Space runs in.
Ids of models the Space uses.
Ids of datasets the Space uses.
Run state of the Space.
Run state: `RUNNING`, `SLEEPING`, `BUILDING`, `RUNTIME_ERROR`, `PAUSED` and more.
Hardware the Space runs on, e.g. `cpu-basic`.
Hardware the owner asked for.
Replicas running.
Replicas the owner asked for.
Build or runtime error text when the Space failed.
The repository's card header (YAML front matter) as the author wrote it: licence, languages, datasets, base model, metrics and more.
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/black-forest-labs/FLUX.1-dev" \
-H "x-api-key: YOUR_API_KEY"Responses
Space details.