# Hugging Face API

> Hugging Face returns public model, dataset, and demo app data, available as a workflow and API.

Hugging Face, also called HF Hub, finds public models by search words, optional task, and sort order, or lists models trending this week. Search datasets by name or topic and choose a result order; results include publisher-provided details such as tasks, languages, and file size. Find public Spaces demos by describing what an app should do and choosing a result order, or get public model details using a model name or link.

- Page: https://fous.com/workflows/hugging-face
- Handle: `@hugging-face`
- Category: [AI](https://fous.com/workflows/category/ai)
- Source website: https://huggingface.co
- Last verified: Sep 29, 2026
- Fous is not affiliated with Hugging Face.

## Methods

### Get model

Operation `get_model`, version 1. 1 credit per call.

Get public details, model card summary, and file sizes for one Hugging Face model from its name or link. For a name, the first matching model is returned; unavailable card details are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `model` | string | yes | `"https://huggingface.co/google-bert/bert-base-uncased"` | Model name, repository name, or Hugging Face model link, for example Llama 3.1 8B Instruct or meta-llama/Llama-3.1-8B-Instruct. |

**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.",
      "examples": [
        "https://huggingface.co/google-bert/bert-base-uncased",
        "Llama 3.1 8B Instruct",
        "meta-llama/Llama-3.1-8B-Instruct"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "model": "https://huggingface.co/google-bert/bert-base-uncased"
    },
    {
      "model": "Llama 3.1 8B Instruct"
    },
    {
      "model": "meta-llama/Llama-3.1-8B-Instruct"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `task` | string or null | `"Fill mask"` |  |
| `files` | array |  |  |
| `files[].name` | string | `".gitattributes"` |  |
| `files[].size_bytes` | integer or null | `491` |  |
| `gated` | boolean | `false` | Whether access to model files requires approval or acceptance. |
| `likes` | integer or null | `3381` |  |
| `author` | string or null | `"google-bert"` |  |
| `license` | string or null | `"Apache 2.0"` |  |
| `languages` | array |  |  |
| `base_model` | string or null | `"meta-llama/Meta-Llama-3.1-8B"` |  |
| `model_name` | string | `"bert-base-uncased"` | Name of the matched model. |
| `datasets_used` | array |  |  |
| `matched_model` | string | `"bert-base-uncased by google-bert"` | The matched model name and publisher, particularly useful for searches by name. |
| `repository_id` | string | `"google-bert/bert-base-uncased"` | Hugging Face repository ID. |
| `model_page_link` | string | `"https://huggingface.co/google-bert/bert-base-uncased"` |  |
| `parameter_count` | integer or null | `110106428` |  |
| `last_updated_date` | string or null | `"2024-02-19"` |  |
| `model_card_summary` | string or null | `"Pretrained model on English language using a masked language modeling (MLM) objective. It was introduced in this paper ` |  |
| `downloads_last_30_days` | integer or null | `41713428` |  |

**Example input**

```json
{
  "model": "https://huggingface.co/google-bert/bert-base-uncased"
}
```

**Example output**

```json
{
  "task": "Fill mask",
  "files": [
    {
      "name": ".gitattributes",
      "size_bytes": 491
    },
    {
      "name": "LICENSE",
      "size_bytes": 11356
    },
    {
      "name": "README.md",
      "size_bytes": 10517
    }
  ],
  "gated": false,
  "likes": 3381,
  "author": "google-bert",
  "license": "Apache 2.0",
  "languages": [
    "en"
  ],
  "base_model": null,
  "model_name": "bert-base-uncased",
  "datasets_used": [
    "bookcorpus",
    "wikipedia"
  ],
  "matched_model": "bert-base-uncased by google-bert",
  "repository_id": "google-bert/bert-base-uncased",
  "model_page_link": "https://huggingface.co/google-bert/bert-base-uncased",
  "parameter_count": 110106428,
  "last_updated_date": "2024-02-19",
  "model_card_summary": "Pretrained model on English language using a masked language modeling (MLM) objective. It was introduced in this paper and first released in this repository. This model is uncased: it does not make a …",
  "downloads_last_30_days": 41713428
}
```

### List trending models

Operation `list_trending_models`, version 1. 1 credit per call.

List Hugging Face models trending this week in trending order, optionally for a task. Downloads reflect the last 30 days; some models have no listed task.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `task` | string | no | `"speech recognition"` | Task in plain words, such as text generation, speech recognition, or image classification. Leave blank for all tasks. |
| `max_results` | integer | no | `5` | Maximum number of trending models to return, such as 20 (up to 100). |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "default": "",
      "description": "Task in plain words, such as text generation, speech recognition, or image classification. Leave blank for all tasks.",
      "examples": [
        "speech recognition",
        "text generation",
        "image classification"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of trending models to return, such as 20 (up to 100).",
      "x-fous-developer": true,
      "examples": [
        5,
        20,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {},
    {
      "task": "speech recognition",
      "max_results": 5
    },
    {
      "task": "text generation",
      "max_results": 20
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `models` | array |  | Models ordered by trending rank. |
| `models[].rank` | integer | `1` | Position in the trending list. |
| `models[].task` | string or null | `"text classification"` | Task in plain words, if listed. |
| `models[].likes` | integer or null | `4302` | Number of likes. |
| `models[].model_name` | string | `"laya"` | Model name. |
| `models[].repository_id` | string | `"convaiinnovations/laya"` | Full repository name in author/name format. |
| `models[].trending_score` | integer or null | `2359` | Hugging Face trending score. |
| `models[].model_page_link` | string | `"https://huggingface.co/convaiinnovations/laya"` | Model page link. |
| `models[].last_updated_date` | string or null | `"2026-09-24"` | Last updated date. |
| `models[].author_or_organization` | string or null | `"convaiinnovations"` | Publishing author or organization. |
| `models[].downloads_last_30_days` | integer or null | `0` | Downloads in the last 30 days. |

**Example input**

```json
{}
```

**Example output**

```json
{
  "models": [
    {
      "rank": 1,
      "task": "text classification",
      "likes": 4302,
      "model_name": "laya",
      "repository_id": "convaiinnovations/laya",
      "trending_score": 2359,
      "model_page_link": "https://huggingface.co/convaiinnovations/laya",
      "last_updated_date": "2026-09-24",
      "author_or_organization": "convaiinnovations",
      "downloads_last_30_days": 0
    },
    {
      "rank": 2,
      "task": "text to image",
      "likes": 2264,
      "model_name": "Qwen-Image-2.1-Uncensored-GGUF",
      "repository_id": "abenzerps/Qwen-Image-2.1-Uncensored-GGUF",
      "trending_score": 1366,
      "model_page_link": "https://huggingface.co/abenzerps/Qwen-Image-2.1-Uncensored-GGUF",
      "last_updated_date": "2026-09-28",
      "author_or_organization": "abenzerps",
      "downloads_last_30_days": 1062921
    },
    {
      "rank": 3,
      "task": "automatic speech recognition",
      "likes": 1407,
      "model_name": "Audio8-ASR-Infinite",
      "repository_id": "Edge0/Audio8-ASR-Infinite",
      "trending_score": 1245,
      "model_page_link": "https://huggingface.co/Edge0/Audio8-ASR-Infinite",
      "last_updated_date": "2026-09-24",
      "author_or_organization": "Edge0",
      "downloads_last_30_days": 19963
    }
  ]
}
```

### Search datasets

Operation `search_datasets`, version 1. 1 credit per call.

Find public Hugging Face datasets by name or topic, ordered by popularity, trending score, or update date. Rows, tasks, languages, license and file size are null when the publisher does not provide them.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"most_liked"` | Result order, for example most_downloaded. |
| `query` | string | yes | `"squad"` | Topic or dataset name, for example medical questions. |
| `max_results` | integer | no | `3` | Maximum number of datasets, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "most_downloaded",
        "most_liked",
        "trending",
        "recently_updated"
      ],
      "type": "string",
      "default": "most_downloaded",
      "description": "Result order, for example most_downloaded.",
      "examples": [
        "most_liked",
        "trending",
        "recently_updated"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Topic or dataset name, for example medical questions.",
      "examples": [
        "squad",
        "medical questions",
        "zyxvnevermatchingqueryaabbcc9911"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of datasets, for example 20.",
      "x-fous-developer": true,
      "examples": [
        3,
        4
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "squad"
    },
    {
      "sort": "most_liked",
      "query": "medical questions",
      "max_results": 3
    },
    {
      "sort": "trending",
      "query": "squad",
      "max_results": 4
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `datasets` | array |  |  |
| `datasets[].rows` | integer or null | `98169` | Number of rows when published. |
| `datasets[].size` | string or null | `"16.3 MB"` | Total file size displayed in decimal units, such as 16.3 MB. |
| `datasets[].likes` | integer or null | `1117` | Number of likes. |
| `datasets[].tasks` | array or null |  | Tasks in plain words. |
| `datasets[].author` | string or null | `"rajpurkar"` | Dataset author or organization. |
| `datasets[].license` | string or null | `"cc-by-sa-4.0"` | Publisher-provided license. |
| `datasets[].languages` | array or null |  | Languages in words when provided. |
| `datasets[].page_link` | string | `"https://huggingface.co/datasets/rajpurkar/squad"` | Dataset page link. |
| `datasets[].dataset_name` | string | `"SQuAD"` | Name displayed by the dataset publisher. |
| `datasets[].last_updated` | string or null | `"2024-03-04"` | Last update date. |
| `datasets[].repository_id` | string | `"rajpurkar/squad"` | Author and repository name. |
| `datasets[].downloads_last_30_days` | integer or null | `260507` | Downloads during the last month. |

**Example input**

```json
{
  "query": "squad"
}
```

**Example output**

```json
{
  "datasets": [
    {
      "rows": 98169,
      "size": "16.3 MB",
      "likes": 1117,
      "tasks": [
        "Question answering"
      ],
      "author": "rajpurkar",
      "license": "cc-by-sa-4.0",
      "languages": [
        "English"
      ],
      "page_link": "https://huggingface.co/datasets/rajpurkar/squad",
      "dataset_name": "SQuAD",
      "last_updated": "2024-03-04",
      "repository_id": "rajpurkar/squad",
      "downloads_last_30_days": 260507
    },
    {
      "rows": 142192,
      "size": "17.7 MB",
      "likes": 263,
      "tasks": [
        "Question answering"
      ],
      "author": "rajpurkar",
      "license": "cc-by-sa-4.0",
      "languages": [
        "English"
      ],
      "page_link": "https://huggingface.co/datasets/rajpurkar/squad_v2",
      "dataset_name": "SQuAD2.0",
      "last_updated": "2024-03-04",
      "repository_id": "rajpurkar/squad_v2",
      "downloads_last_30_days": 81226
    },
    {
      "rows": null,
      "size": "7.5 GB",
      "likes": 0,
      "tasks": null,
      "author": "research-backup",
      "license": null,
      "languages": null,
      "page_link": "https://huggingface.co/datasets/research-backup/qa_squadshifts_synthetic_random",
      "dataset_name": "qa_squadshifts_synthetic_random",
      "last_updated": "2023-01-15",
      "repository_id": "research-backup/qa_squadshifts_synthetic_random",
      "downloads_last_30_days": 17240
    }
  ]
}
```

### Search models

Operation `search_models`, version 1. 1 credit per call.

Find public Hugging Face models by search words, with an optional task and sort order. License is null when the model does not publish one.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"trending"` | Order of results; for example "trending". Defaults to most_downloaded. |
| `task` | string | no | `"text generation"` | Task in plain words, such as "text generation", "image classification", or "sentiment analysis". Defaults to all tasks. |
| `query` | string | yes | `"whisper"` | Search words for model names, such as "whisper" or "sentiment analysis". |
| `max_results` | integer | no | `20` | Maximum models to return, for example 20; at most 100. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "most_downloaded",
        "most_liked",
        "trending",
        "recently_updated"
      ],
      "type": "string",
      "default": "most_downloaded",
      "examples": [
        "trending"
      ],
      "description": "Order of results; for example \"trending\". Defaults to most_downloaded."
    },
    "task": {
      "type": "string",
      "default": "all tasks",
      "examples": [
        "text generation"
      ],
      "description": "Task in plain words, such as \"text generation\", \"image classification\", or \"sentiment analysis\". Defaults to all tasks."
    },
    "query": {
      "type": "string",
      "examples": [
        "whisper"
      ],
      "minLength": 1,
      "description": "Search words for model names, such as \"whisper\" or \"sentiment analysis\"."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum models to return, for example 20; at most 100.",
      "x-fous-developer": true
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "whisper"
    },
    {
      "sort": "trending",
      "task": "text generation",
      "query": "llama",
      "max_results": 4
    },
    {
      "sort": "most_liked",
      "task": "sentiment analysis",
      "query": "sentiment analysis",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `models` | array |  | Matching models in the requested order. |
| `models[].task` | string or null | `"Automatic Speech Recognition"` | Model task in words. |
| `models[].likes` | integer or null | `233` | Total likes. |
| `models[].author` | string or null | `"argmaxinc"` | Publisher or organization. |
| `models[].license` | string or null | `"mit"` | License as stated by the model publisher. |
| `models[].model_name` | string | `"whisperkit-coreml"` | Model repository name. |
| `models[].repository_id` | string | `"argmaxinc/whisperkit-coreml"` | Repository ID (author/name). |
| `models[].model_page_link` | string | `"https://huggingface.co/argmaxinc/whisperkit-coreml"` | Hugging Face model page. |
| `models[].last_updated_date` | string or null | `"2026-08-19"` | Most recent update date. |
| `models[].downloads_last_30_days` | integer or null | `10863294` | Downloads over the last 30 days. |

**Example input**

```json
{
  "query": "whisper"
}
```

**Example output**

```json
{
  "models": [
    {
      "task": "Automatic Speech Recognition",
      "likes": 233,
      "author": "argmaxinc",
      "license": "mit",
      "model_name": "whisperkit-coreml",
      "repository_id": "argmaxinc/whisperkit-coreml",
      "model_page_link": "https://huggingface.co/argmaxinc/whisperkit-coreml",
      "last_updated_date": "2026-08-19",
      "downloads_last_30_days": 10863294
    },
    {
      "task": "Automatic Speech Recognition",
      "likes": 3403,
      "author": "openai",
      "license": "mit",
      "model_name": "whisper-large-v3-turbo",
      "repository_id": "openai/whisper-large-v3-turbo",
      "model_page_link": "https://huggingface.co/openai/whisper-large-v3-turbo",
      "last_updated_date": "2024-10-04",
      "downloads_last_30_days": 6369929
    },
    {
      "task": "Automatic Speech Recognition",
      "likes": 6448,
      "author": "openai",
      "license": "apache-2.0",
      "model_name": "whisper-large-v3",
      "repository_id": "openai/whisper-large-v3",
      "model_page_link": "https://huggingface.co/openai/whisper-large-v3",
      "last_updated_date": "2024-08-12",
      "downloads_last_30_days": 4370479
    }
  ]
}
```

### Search spaces

Operation `search_spaces`, version 1. 1 credit per call.

Find public Hugging Face Spaces demos for a task, with descriptions, likes, running status, and update dates. Availability and running status can change.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"most_liked"` | Order results by relevance, most_liked, or trending. For example, most_liked. |
| `query` | string | yes | `"remove image background"` | What the app should do, for example, remove image background. |
| `max_results` | integer | no | `5` | Maximum number of Spaces to return, for example, 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "most_liked",
        "trending"
      ],
      "type": "string",
      "default": "relevance",
      "description": "Order results by relevance, most_liked, or trending. For example, most_liked.",
      "examples": [
        "most_liked",
        "trending"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "What the app should do, for example, remove image background.",
      "examples": [
        "remove image background",
        "asdfzqixxqoz1234q99875",
        "generate images"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of Spaces to return, for example, 20.",
      "x-fous-developer": true,
      "examples": [
        5,
        100
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "remove image background"
    },
    {
      "sort": "most_liked",
      "query": "remove image background",
      "max_results": 5
    },
    {
      "query": "asdfzqixxqoz1234q99875"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `spaces` | array |  | Matching public demo apps. |
| `spaces[].likes` | integer | `2956` | Number of likes. |
| `spaces[].author` | string | `"not-lain"` | Name of the publisher. |
| `spaces[].app_link` | string | `"https://huggingface.co/spaces/not-lain/background-removal"` | Link to the app page. |
| `spaces[].app_name` | string | `"Background Removal"` | Name of the demo app. |
| `spaces[].hardware` | string or null | `"ZERO A10G"` | Current hardware when running, otherwise requested hardware, if available. |
| `spaces[].running_now` | boolean | `true` | Whether the app is currently running. |
| `spaces[].last_updated` | string or null | `"2026-04-20"` | Date the Space was last updated, if available. |
| `spaces[].app_framework` | string or null | `"Gradio"` | Framework for the Space, if available. |
| `spaces[].short_description` | string or null | `"Remove backgrounds from images instantly"` | Short description of the app, if available. |
| `spaces[].space_repository_id` | string | `"not-lain/background-removal"` | Space repository ID in author/name form. |

**Example input**

```json
{
  "query": "remove image background"
}
```

**Example output**

```json
{
  "spaces": [
    {
      "likes": 2956,
      "author": "not-lain",
      "app_link": "https://huggingface.co/spaces/not-lain/background-removal",
      "app_name": "Background Removal",
      "hardware": "ZERO A10G",
      "running_now": true,
      "last_updated": "2026-04-20",
      "app_framework": "Gradio",
      "short_description": "Remove backgrounds from images instantly",
      "space_repository_id": "not-lain/background-removal"
    },
    {
      "likes": 891,
      "author": "briaai",
      "app_link": "https://huggingface.co/spaces/briaai/BRIA-RMBG-1.4",
      "app_name": "BRIA RMBG 1.4",
      "hardware": "CPU BASIC",
      "running_now": true,
      "last_updated": "2025-01-07",
      "app_framework": "Gradio",
      "short_description": "Remove backgrounds from images instantly",
      "space_repository_id": "briaai/BRIA-RMBG-1.4"
    },
    {
      "likes": 878,
      "author": "prithivMLmods",
      "app_link": "https://huggingface.co/spaces/prithivMLmods/Qwen-Image-Edit-2509-LoRAs-Fast",
      "app_name": "Qwen-Image-Edit-2509-LoRAs-Fast",
      "hardware": "ZERO A10G",
      "running_now": true,
      "last_updated": "2026-08-08",
      "app_framework": "Gradio",
      "short_description": "Demo of the Collection of Qwen Image Edit LoRAs",
      "space_repository_id": "prithivMLmods/Qwen-Image-Edit-2509-LoRAs-Fast"
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@hugging-face",
  "visibility": "public",
  "operation": "get_model",
  "version": 1,
  "input": {
    "model": "https://huggingface.co/google-bert/bert-base-uncased"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@hugging-face\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_model\",\n  \"version\": 1,\n  \"input\": {\n    \"model\": \"https://huggingface.co/google-bert/bert-base-uncased\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@hugging-face",
  "visibility": "public",
  "operation": "get_model",
  "version": 1,
  "input": {
    "model": "https://huggingface.co/google-bert/bert-base-uncased"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@hugging-face","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Compare public models by task, likes, and recent downloads
- Review a model’s publisher, license, files, and model card summary
- Find datasets for a topic and compare their published details
- Track models trending this week by task
- Discover demo apps for a specific task

## FAQ

### Is Fous affiliated with Hugging Face?

No. Fous is not affiliated with Hugging Face. This workflow reads the public huggingface.co website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a Hugging Face account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from huggingface.co when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### Which public models match a search or task?

Use Search models with required search words and an optional task and sort order.

### What details are available for a model?

Get model returns public details, a model card summary, and file sizes for a model name or link.

### Which models are trending this week?

List trending models returns models in trending order, optionally filtered by task.

## Related

- [Kaggle API](https://fous.com/workflows/kaggle.md): Discover public datasets on Kaggle.
- [TMDB API](https://fous.com/workflows/tmdb.md): TMDB returns movie and TV details, cast, trailers, releases, viewing services, scheduled upcoming movies, and up to 20 homepage trending titles; future episode details depend on published schedules.
- [OpenRouter API](https://fous.com/workflows/openrouter.md): OpenRouter lets you browse and compare AI models by price, context, supported inputs, release date, hosting providers, and reported one-day uptime when available.
- [GitHub API](https://fous.com/workflows/github.md): GitHub returns public repository matches and details, up to 25 trending projects, issues, pull requests, and newest-first published releases; release or commit dates may be unavailable.
- [Google Trends API](https://fous.com/workflows/google-trends.md): Google Trends compares relative search interest over time and by region, shows related searches and current trends, with daily peaks for seven-day views.
- [CoinGecko API](https://fous.com/workflows/coingecko.md): CoinGecko returns cryptocurrency prices and histories, sector rankings and details, and trending coins; non-USD historical values cover 365 days, histories 7–365 days, and today’s prices may change.
- [TikTok Creative Center API](https://fous.com/workflows/tiktok-creative-center.md): Explore publicly visible TikTok marketing trends.
- [The Space Devs API](https://fous.com/workflows/the-space-devs.md): The Space Devs provides worldwide rocket launch schedules and mission details; public development listings may lag, and some launch details may be missing.
- [All AI workflows](https://fous.com/workflows/category/ai)