# Hugging Face API: Get model details

> Looks up one Hugging Face model by name, repository ID or link and returns its public details, model card summary and file sizes. For a name, the first matching model is returned.

Unofficial. Not affiliated with or endorsed by Hugging Face.

- Page: https://fous.com/methods/huggingface.co/get-model
- Method: `huggingface.co/get_model`, version 1
- Website: huggingface.co
- Returns: model name, matched model, author, task, license, gated, downloads, likes, last updated date, parameter count, base model, languages, datasets, model card summary, files, page link, repository ID
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `model` | string | yes | `"Llama 3.1 8B Instruct"` | Model name, repository name, or Hugging Face model link, for example Llama 3.1 8B Instruct or meta-llama/Llama-3.1-8B-Instruct. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "model": "Llama 3.1 8B Instruct"
}
```

Its output:

```json
{
  "task": "Text generation",
  "files": [
    {
      "name": ".gitattributes",
      "size_bytes": 1519
    },
    {
      "name": "LICENSE",
      "size_bytes": 7627
    },
    {
      "name": "README.md",
      "size_bytes": 44044
    }
  ],
  "gated": true,
  "likes": 8563,
  "author": "meta-llama",
  "license": "Llama 3.1",
  "languages": [
    "en",
    "de",
    "fr"
  ],
  "base_model": "meta-llama/Meta-Llama-3.1-8B",
  "model_name": "Llama-3.1-8B-Instruct",
  "datasets_used": [],
  "matched_model": "Llama-3.1-8B-Instruct by meta-llama",
  "repository_id": "meta-llama/Llama-3.1-8B-Instruct",
  "model_page_link": "https://huggingface.co/meta-llama/Llama-3.1-8B-Instruct",
  "parameter_count": 8030261248,
  "last_updated_date": "2024-09-25",
  "model_card_summary": "The Meta Llama 3.1 collection of multilingual large language models (LLMs) is a collection of pretrained and instruction tuned generative models in 8B, 70B and 405B sizes (text in/text out). The Llama 3.1 instruction tuned text only models (8B, 70B, 405B) are optimized for multilingual dialogue use …",
  "downloads_last_30_days": 4864172
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"huggingface.co/get_model","input":{"model":"Llama 3.1 8B Instruct"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What is the license and download count for meta-llama/Llama-3.1-8B-Instruct on Hugging Face?
- Show me the model card summary and file sizes for the Mistral 7B Instruct model.
- Is the gemma-2-9b model gated, and when was it last updated?
- Look up the parameter count and base model for https://huggingface.co/Qwen/Qwen2.5-7B-Instruct.
- Find the author, task type, and number of likes for the Whisper large-v3 model on Hugging Face.

## Input schema

```json
{
  "type": "object",
  "required": [
    "model"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "Model name, repository name, or Hugging Face model link, for example Llama 3.1 8B Instruct or meta-llama/Llama-3.1-8B-Instruct."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "model_name",
    "matched_model",
    "author",
    "task",
    "license",
    "gated",
    "downloads_last_30_days",
    "likes",
    "last_updated_date",
    "parameter_count",
    "base_model",
    "languages",
    "datasets_used",
    "model_card_summary",
    "files",
    "model_page_link",
    "repository_id"
  ],
  "properties": {
    "task": {
      "type": [
        "string",
        "null"
      ]
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "size_bytes"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "size_bytes": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    },
    "gated": {
      "type": "boolean",
      "description": "Whether access to model files requires approval or acceptance."
    },
    "likes": {
      "type": [
        "integer",
        "null"
      ]
    },
    "author": {
      "type": [
        "string",
        "null"
      ]
    },
    "license": {
      "type": [
        "string",
        "null"
      ]
    },
    "languages": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "base_model": {
      "type": [
        "string",
        "null"
      ]
    },
    "model_name": {
      "type": "string",
      "description": "Name of the matched model."
    },
    "datasets_used": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "matched_model": {
      "type": "string",
      "description": "The matched model name and publisher, particularly useful for searches by name."
    },
    "repository_id": {
      "type": "string",
      "description": "Hugging Face repository ID."
    },
    "model_page_link": {
      "type": "string"
    },
    "parameter_count": {
      "type": [
        "integer",
        "null"
      ]
    },
    "last_updated_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "model_card_summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "downloads_last_30_days": {
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [Hugging Face API: Search models](https://fous.com/methods/huggingface.co/search-models.md): Finds public Hugging Face models by search words, with an optional task and sort order. License is null when the model does not publish one.
- [Hugging Face API: List trending models](https://fous.com/methods/huggingface.co/list-trending-models.md): Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.
- [Hugging Face API: Search datasets](https://fous.com/methods/huggingface.co/search-datasets.md): Finds public Hugging Face datasets by name or topic, ordered by downloads, likes, trending score or last update.
- [Hugging Face API: Search Hugging Face Spaces](https://fous.com/methods/huggingface.co/search-spaces.md): Finds public Hugging Face Spaces demos for a task, with descriptions, likes, running status and update dates.
- [OpenRouter API: Get model details](https://fous.com/methods/openrouter.ai/get-model.md): Looks up an OpenRouter model by name, slug or model link and returns its prices, limits, supported inputs, release date and hosting providers.
- [GitHub API: Get repository facts](https://fous.com/methods/github.com/get-repository.md): Looks up a public GitHub repository by name, owner/name, or link and returns its stars, forks, release, commit and contributor facts.
- [NHTSA API: List vehicle models](https://fous.com/methods/nhtsa.gov/list-vehicle-models.md): Lists the passenger car, SUV/minivan and truck models NHTSA has for a make and model year, alphabetically.
- [Amazon API: Get product](https://fous.com/methods/amazon.com/get-product.md): Gets details for an Amazon product, found by name or by link, in a chosen country store. Offer prices, delivery and variants may be missing when Amazon does not show them publicly.
- [All Hugging Face methods](https://fous.com/methods/huggingface.co.md)