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

---

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

## Request

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

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