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

---

# Hugging Face Dataset API

One dataset with its description, licence tags, languages, data sizes and card metadata.

`GET /v1/hugging-face/datasets/{owner}/{name}` returns `dataset` with the summary fields plus `description`, `citation`, `paperswithcodeId`, `mainSizeBytes`, `usedStorageBytes`, `languages` and `card`.

The summary fields cover `id`, `url`, `author`, `likes`, `downloads`, `downloadsAllTime`, `trendingScore`, `gated`, `tags`, `license` and `lastModified`. `revision` selects a branch, tag or commit. Branch on `lookupStatus`: a private dataset returns `not_found`, so a miss does not prove the name is unused.

## Request

- **Endpoint:** `GET /v1/hugging-face/datasets/{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/datasets/owner/name/get)
- **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face)

## FAQ

### Does this tell me whether the dataset rows are available?

No. This endpoint returns the dataset record. Use GET /v1/hugging-face/datasets/{owner}/{name}/viewer for the row facts and the rows endpoint for data.

### Where is the full dataset card?

description is a trimmed extract. The README endpoint returns the whole card as markdown, including its YAML header.

### What are mainSizeBytes and usedStorageBytes?

mainSizeBytes is the size of the main data files. usedStorageBytes is all storage the repository uses.

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