> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/hugging-face/spaces-owner-name>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hugging-face/spaces-owner-name.mdx>

---

# Hugging Face Space API

One Space with its app URL, runtime state, hardware, replicas and the models and datasets it uses.

`GET /v1/hugging-face/spaces/{owner}/{name}` returns `space`. The summary fields include `id`, `url`, `author`, `likes`, `downloads`, `sdk`, `spaceStage` and `tags`; the detail adds `subdomain`, `appUrl`, `region`, `models`, `datasets`, `runtime` and `card`.

`runtime` carries `stage`, `hardware`, `requestedHardware`, `replicas`, `requestedReplicas` and `errorMessage`. `revision` selects a branch, tag or commit. HTTP is 200 for every outcome, so check `lookupStatus`; a private Space returns `not_found`.

## Request

- **Endpoint:** `GET /v1/hugging-face/spaces/{owner}/{name}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by owner and name
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/hugging-face/spaces/owner/name/get)
- **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face)

## FAQ

### How do I get the URL of the running app?

Read space.appUrl. space.subdomain is the host label the app uses.

### Why is runtime null?

Some Spaces have no runtime block, for example static Spaces. The repository fields are still present.

### Which models and datasets does the Space use?

space.models and space.datasets list the repository ids. They are empty when the Space declares none.

### How much does a Space lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.