Hugging Face

Get Hugging Face model

Get a Hugging Face model with its downloads, tags, card, weights, base models and evaluation results. Pass the full repository id as `owner/name`, for…

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

API key (`sfk_...`)

Parameters
4
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._/-]*$

includestringoptionalquery

Extra blocks, comma-separated: `config` (config.json), `spaces` (Spaces that use the model) and `security` (scan result).

Response fields
81

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

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

datamodelid
string

Repository id, `owner/name`.

datamodeltype
string

Repository type.

one of: model, dataset, space

datamodeluid
stringnullable

Stable repository id; survives renames.

datamodelurl
string

Repository page URL.

datamodelauthor
stringnullable

Owner account name.

datamodelcreatedAt
stringnullable

When the repository was created (ISO-8601).

datamodellastModified
stringnullable

When the repository last changed (ISO-8601).

datamodelsha
stringnullable

Latest commit on the default branch.

datamodellikes
integernullable

Likes.

datamodeldownloads
integernullable

Downloads in the last 30 days.

datamodeldownloadsAllTime
integernullable

Downloads since the repository was created.

datamodeltrendingScore
numbernullable

Trending score.

datamodelgated

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

datamodeldisabled
booleannullable

Whether the repository has been disabled.

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

datamodeltags[]
stringoptional
datamodelpipelineTag
stringnullable

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

datamodellibrary
stringnullable

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

datamodellicense
stringnullable

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

datamodelsdk
stringnullable

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

datamodelparameters
integernullable

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

datamodelspaceStage
stringnullable

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

Language codes from the card.

datamodellanguages[]
stringoptional

Dataset ids the card names.

datamodeldatasets[]
stringoptional

The models this one was built from.

datamodelbaseModelsrelation
stringnullable

How this model relates to its base models: `finetune`, `adapter`, `merge` or `quantized`.

Base model ids.

datamodelbaseModelsmodels[]
stringoptional

How many models are built on this one.

datamodelderivedModelCountsadapter
integer

Adapters built on this model.

datamodelderivedModelCountsfinetune
integer

Finetunes of this model.

datamodelderivedModelCountsmerge
integer

Merges that use this model.

datamodelderivedModelCountsquantized
integer

Quantized versions of this model.

Weight sizes from the safetensors files.

datamodelsafetensorstotal
integernullable

Total parameters.

datamodelsafetensorsparameters
object

Parameters per data type, e.g. `{ "F32": 137022720 }`.

GGUF file facts, for models that ship GGUF files.

datamodelggufarchitecture
stringnullable

Model architecture.

datamodelggufcontextLength
integernullable

Context length in tokens.

datamodelgguftotal
integernullable

Total parameters.

datamodelgguftotalFileSize
integernullable

Total size of the GGUF files in bytes.

datamodelggufbosToken
stringnullable

Beginning-of-sequence token.

datamodelggufeosToken
stringnullable

End-of-sequence token.

How the Transformers library loads the model.

datamodeltransformersautoModel
stringnullable

Auto class that loads the model.

datamodeltransformerspipelineTag
stringnullable

Pipeline task.

datamodeltransformersprocessor
stringnullable

Processor class.

Hosted inference providers that serve the model.

datamodelinferenceProviders[]provider
string

Provider id.

datamodelinferenceProviders[]status
stringnullable

Provider status, e.g. `live`.

datamodelinferenceProviders[]providerModelId
stringnullable

The model's id at the provider.

datamodelinferenceProviders[]task
stringnullable

Task the provider serves.

datamodelinferenceProviders[]isModelAuthor
booleannullable

Whether the provider is the model's author.

Evaluation results published in the repository.

datamodelevalResults[]filename
string

Evaluation file in the repository.

datamodelevalResults[]verified
booleannullable

Whether the result is verified.

datamodelevalResults[]pullRequest
integernullable

Pull request that added the result.

datamodelevalResults[]data
objectnullable

The evaluation entry as written.

datamodelusedStorageBytes
integernullable

Storage the repository uses, in bytes.

datamodelmaskToken
stringnullable

Mask token of a fill-mask model.

Example inputs shown on the model page.

datamodelwidgetExamples[]
objectoptional
datamodelcard
objectnullable

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

datamodelconfig
objectnullable

The model's config.json. Only with `include=config`; otherwise null.

Ids of Spaces that use the model. Only with `include=spaces`; otherwise null.

datamodelspaces[]
stringoptional

Security scan result. Only with `include=security`; otherwise null.

datamodelsecurityscansDone
booleannullable

Whether the security scans have finished.

Files the scans flagged.

datamodelsecurityfilesWithIssues[]path
stringnullable

File with a finding.

datamodelsecurityfilesWithIssues[]level
stringnullable

Severity of the finding.

datamodelsecurityfilesWithIssues[]message
stringnullable

What was found.

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/models/openai-community/gpt2" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Model details.