Social Fetch
Start for freeStart free
Hugging Face hub

Hugging Face Dataset API

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

GET /v1/hugging-face/datasets/{owner}/{name}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Hugging Face Dataset API 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.

Other Hugging Face endpoints