Hugging Face

Search Hugging Face Spaces by meaning

Search Hugging Face Spaces that match a plain-words description.

GET/v1/hugging-face/spaces/semantic-search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

What you are looking for, in plain words.

min 1 chars · max 200 chars

categorystringoptionalquery

Only Spaces in this category.

pattern: ^[a-z0-9-]{1,40}$

sdkstringoptionalquery

Only Spaces built with this SDK.

one of: gradio, streamlit, docker, static

Response fields
29

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

Spaces ranked by how well they match, best first.

dataresults[]id
string

Repository id, `owner/name`.

dataresults[]type
string

Repository type.

one of: model, dataset, space

dataresults[]uid
stringnullable

Stable repository id; survives renames.

dataresults[]url
string

Repository page URL.

dataresults[]author
stringnullable

Owner account name.

dataresults[]createdAt
stringnullable

When the repository was created (ISO-8601).

dataresults[]lastModified
stringnullable

When the repository last changed (ISO-8601).

dataresults[]sha
stringnullable

Latest commit on the default branch.

dataresults[]likes
integernullable

Likes.

dataresults[]downloads
integernullable

Downloads in the last 30 days.

dataresults[]downloadsAllTime
integernullable

Downloads since the repository was created.

dataresults[]trendingScore
numbernullable

Trending score.

dataresults[]gated

Whether access needs approval: `false`, `auto` (accepted on request) or `manual` (reviewed by the owner).

dataresults[]disabled
booleannullable

Whether the repository has been disabled.

Tags: task, library, languages, licence and more.

dataresults[]tags[]
stringoptional
dataresults[]pipelineTag
stringnullable

Main task of a model, e.g. `text-generation`; null in dataset and Space results.

dataresults[]library
stringnullable

Library a model is made for, e.g. `transformers`; null in dataset and Space results.

dataresults[]license
stringnullable

Licence id taken from the tags, e.g. `mit`.

dataresults[]sdk
stringnullable

SDK of a Space, e.g. `gradio`; null in model and dataset results.

dataresults[]parameters
integernullable

Parameter count of a model, when known; null in dataset and Space results.

dataresults[]spaceStage
stringnullable

Run state of a Space, e.g. `RUNNING` or `SLEEPING`; null in model and dataset results.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/hugging-face/spaces/semantic-search?query=bert" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Spaces ranked by match.