> **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>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hugging-face/spaces.mdx>

---

# Hugging Face Spaces API

Find demos by keyword, author, SDK or tag, with run state and repository stats on every row.

`GET /v1/hugging-face/spaces` returns a page of Spaces in `results`. Use `query`, `author`, `sdk` (`gradio`, `streamlit`, `docker` or `static`), `tags`, `sort`, `order`, `limit` and `cursor`.

Each row carries `id`, `url`, `author`, `sdk`, `spaceStage`, `likes`, `downloads`, `trendingScore`, `tags` and `lastModified`. Sort by `downloads`, `likes`, `likes7d`, `likes30d`, `trending`, `created` or `updated`, and keep asking with `page.nextCursor` while `page.hasMore` is true.

## Request

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

## FAQ

### Which SDKs can I filter by?

sdk accepts gradio, streamlit, docker or static. Omit it to search every Space.

### What is spaceStage?

It is the Space's run state, for example RUNNING, SLEEPING or BUILDING. The detail endpoint gives the fuller runtime block.

### Can I find Spaces by what they do rather than a keyword?

Yes. GET /v1/hugging-face/spaces/semantic-search ranks Spaces by how well they match a plain-language description.

### How much does a Space search 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. Each paginated page is a separate billed request.