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

---

# 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}/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.

## Request

- **Endpoint:** `GET /v1/hugging-face/accounts/{name}/buckets`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by account name
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/hugging-face/accounts/name/buckets/get)
- **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face)

## 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.