Hugging Face Storage Buckets API
An account's public storage buckets, with size, file count and the times they changed.
GET /v1/hugging-face/accounts/{name}/buckets1 credit Failed requests are free
About this endpoint
GET /v1/hugging-face/accounts/{name}/buckets returns buckets. Each bucket has id, uid, url, createdAt, updatedAt, sizeBytes and fileCount.
Use query to keep only buckets whose id contains a text. An account with no public buckets, or a name that does not exist, returns lookupStatus: not_found with an empty list.
Hugging Face Storage Buckets API FAQ
Does this list private buckets?
No. Only public storage buckets are returned.
What is a bucket id?
It is owner/name, and it is also the value you filter with query.
Why is the list empty?
The account may have no public buckets, or the name may not exist. Read lookupStatus to tell which.
How much does a bucket list 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