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

---

# Hugging Face Model API

One model with its card, weight facts, base models, evaluation results and the providers that serve it.

`GET /v1/hugging-face/models/{owner}/{name}` returns `model` with the summary fields plus the card metadata as `card`, `languages`, `datasets`, `baseModels`, `derivedModelCounts`, `safetensors`, `gguf`, `transformers`, `inferenceProviders`, `evalResults`, `usedStorageBytes` and `widgetExamples`.

Pass the full repository id as `owner/name`, for example `openai-community/gpt2`; a bare id such as `gpt2` is not accepted. `include` adds optional blocks: `config` for `config.json`, `spaces` for the Spaces that use the model, and `security` for scan findings. `revision` selects a branch, tag or commit. HTTP is 200 for every outcome, so branch on `lookupStatus` (`found` or `not_found`); a private model returns `not_found`.

## Request

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

## FAQ

### What does include=config return?

include=config adds the model's config.json as model.config. Without it, model.config is null.

### Can I see which Spaces use a model?

Yes, with include=spaces. The result is model.spaces, a list of Space ids; it is null when the block was not requested.

### What does lookupStatus tell me?

found means the model was returned. not_found means there is no public model with that owner and name, which also covers a private model.

### How do I read a specific revision?

Pass revision as a branch, tag or commit. The default is main.

### How much does a model 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.
