Hugging Face

Get Hugging Face dataset

Get a Hugging Face dataset with its downloads, tags, description and card.

GET/v1/hugging-face/datasets/{owner}/{name}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
ownerstringrequiredpath

Owner of the repository: a user or organization name.

pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$

namestringrequiredpath

Repository name, without the owner.

pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$

revisionstringoptionalquery

Branch, tag or commit. Default: the default branch (`main`).

min 1 chars · max 200 chars · pattern: ^[A-Za-z0-9][A-Za-z0-9._/-]*$

Response fields
37

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The dataset when lookupStatus is `found`; otherwise null.

datadatasetid
string

Repository id, `owner/name`.

datadatasettype
string

Repository type.

one of: model, dataset, space

datadatasetuid
stringnullable

Stable repository id; survives renames.

datadataseturl
string

Repository page URL.

datadatasetauthor
stringnullable

Owner account name.

datadatasetcreatedAt
stringnullable

When the repository was created (ISO-8601).

datadatasetlastModified
stringnullable

When the repository last changed (ISO-8601).

datadatasetsha
stringnullable

Latest commit on the default branch.

datadatasetlikes
integernullable

Likes.

datadatasetdownloads
integernullable

Downloads in the last 30 days.

datadatasetdownloadsAllTime
integernullable

Downloads since the repository was created.

datadatasettrendingScore
numbernullable

Trending score.

datadatasetgated

Whether access needs approval: `false`, `auto` (accepted on request) or `manual` (reviewed by the owner).

datadatasetdisabled
booleannullable

Whether the repository has been disabled.

Tags: task, library, languages, licence and more.

datadatasettags[]
stringoptional
datadatasetpipelineTag
stringnullable

Main task of a model, e.g. `text-generation`; null in dataset and Space results.

datadatasetlibrary
stringnullable

Library a model is made for, e.g. `transformers`; null in dataset and Space results.

datadatasetlicense
stringnullable

Licence id taken from the tags, e.g. `mit`.

datadatasetsdk
stringnullable

SDK of a Space, e.g. `gradio`; null in model and dataset results.

datadatasetparameters
integernullable

Parameter count of a model, when known; null in dataset and Space results.

datadatasetspaceStage
stringnullable

Run state of a Space, e.g. `RUNNING` or `SLEEPING`; null in model and dataset results.

datadatasetdescription
stringnullable

Description from the dataset card, trimmed. Read the README endpoint for the full card.

datadatasetcitation
stringnullable

Citation text.

datadatasetpaperswithcodeId
stringnullable

Papers with Code dataset id.

datadatasetmainSizeBytes
integernullable

Size of the main data files in bytes.

datadatasetusedStorageBytes
integernullable

Storage the repository uses, in bytes.

Language codes from the card.

datadatasetlanguages[]
stringoptional
datadatasetcard
objectnullable

The repository's card header (YAML front matter) as the author wrote it: licence, languages, datasets, base model, metrics and more.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/hugging-face/datasets/stanfordnlp/imdb" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Dataset details.