Hugging Face Search API
One query across every kind of result, grouped so you can see what exists before you open a list.
GET /v1/hugging-face/search1 credit Failed requests are free
About this endpoint
GET /v1/hugging-face/search takes a required query and an optional type (model, dataset, space, org, user, paper, collection, bucket, kernel or blog). It returns query and ten groups: models, datasets, spaces, organizations, users, papers, collections, buckets, kernels and blogs.
Each group has total and items, and each item has id, url and title where the match has one. Groups that do not match are empty. This is a discovery call; use the per-kind endpoints to page a full result set.
Hugging Face Search API FAQ
How many results come back?
A few per group, enough to show what matches. This endpoint has no cursor; use the per-kind search endpoints to page.
Can I search only papers?
Yes. Set type=paper. Omit type to search every kind.
Does a group with no matches return an error?
No. Its total is 0 and its items are empty. HTTP 200 only means the request finished.
How much does a global 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