Hugging Face Semantic Space Search API
Describe what you need in plain words and get the Spaces that fit, ranked best first.
GET /v1/hugging-face/spaces/semantic-search1 credit Failed requests are free
About this endpoint
GET /v1/hugging-face/spaces/semantic-search takes a required query written in plain words and returns results, the Spaces ranked by how well they match. Narrow the list with category and sdk (gradio, streamlit, docker or static).
Each result is a repository summary with id, url, author, sdk, spaceStage, likes, downloads, tags and trendingScore. This is not keyword search over ids; it matches the meaning of the description.
Hugging Face Semantic Space Search API FAQ
How is this different from the Spaces search endpoint?
The Spaces search endpoint matches ids, tags and card text. This one ranks by how well a Space matches the meaning of your description.
Can I restrict the SDK?
Yes. sdk accepts gradio, streamlit, docker or static. category narrows it further.
Why are the scores not returned?
The results are already in ranked order. The endpoint returns the repositories, not the similarity scores.
How much does a semantic 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.
Other Hugging Face endpoints
- Search modelsGET /v1/hugging-face/models
- Get modelGET /v1/hugging-face/models/{owner}/{name}
- Search datasetsGET /v1/hugging-face/datasets
- Get datasetGET /v1/hugging-face/datasets/{owner}/{name}
- Search SpacesGET /v1/hugging-face/spaces
- Get SpaceGET /v1/hugging-face/spaces/{owner}/{name}
- READMEGET /v1/hugging-face/repos/{repoType}/{owner}/{name}/readme
- FilesGET /v1/hugging-face/repos/{repoType}/{owner}/{name}/files