Hugging Face

List Hugging Face buckets

List the public storage buckets of a Hugging Face account.

GET/v1/hugging-face/accounts/{name}/buckets
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
namestringrequiredpath

Hugging Face user or organization name, e.g. `clem`.

pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$

querystringoptionalquery

Only buckets whose id contains this text.

min 1 chars · max 100 chars

Response fields
14

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The account's public storage buckets.

databuckets[]id
string

Bucket id, `owner/name`.

databuckets[]uid
stringnullable

Stable bucket id.

databuckets[]url
string

Bucket page URL.

databuckets[]createdAt
stringnullable

When the bucket was created (ISO-8601).

databuckets[]updatedAt
stringnullable

When the bucket last changed (ISO-8601).

databuckets[]sizeBytes
integernullable

Total size in bytes.

databuckets[]fileCount
integernullable

Files in the bucket.

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/accounts/huggingface/buckets" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Bucket list.