Social Fetch
Start for freeStart free
Hugging Face hub

Hugging Face Account API

One user or organization with its profile, public counts, organizations and hardware, in one shape.

GET /v1/hugging-face/accounts/{name}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/hugging-face/accounts/{name} returns account with type (user or org), username, uid, displayName, url, avatarUrl, bio, joinedAt, isPro, isVerified, plan, counts, organizations, primaryOrganizationAvatarUrl and hardware.

counts holds public figures such as models, datasets, spaces, papers, followers, following, members and likes; a count that does not apply to that account is null. Add include=socials to fill socials with the handles the account entered. Users and organizations share one namespace, so check type before reading user-only fields.

Hugging Face Account API FAQ

How do I tell a user from an organization?

Read account.type. It is user or org, and fields such as joinedAt, isPro and hardware are user-only.

How do I get social handles?

Pass include=socials. Without it, account.socials is null.

What counts are available?

The counts object covers models, datasets, Spaces, papers, kernels, buckets, discussions, upvotes, likes, followers, following, followingOrganizations and members. Counts that do not apply are null.

How much does an account lookup 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