> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/hugging-face/tags>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hugging-face/tags.mdx>

---

# Hugging Face Tags API

The valid values behind the filters: task ids, libraries, languages, licences, sizes, formats and more.

`GET /v1/hugging-face/tags` returns `kind`, `group` and `tags`. `kind` is `models` (default) or `datasets`, and `group` is required. For models the groups include `pipeline_tag`, `library`, `dataset`, `bucket`, `language`, `license`, `arxiv`, `doi`, `region`, `deploy` and `other`; datasets have their own list, including `benchmark`, `task_categories`, `task_ids`, `size_categories`, `modality` and `format`.

Each tag has `id` (the value to pass to a filter), `label`, `group` and `subGroup`. Use `query` to keep only tags whose id or label contains a text. A group that does not belong to the kind is refused with a 400.

## Request

- **Endpoint:** `GET /v1/hugging-face/tags`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by group
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/hugging-face/tags/get)
- **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face)

## FAQ

### How do I get the task ids for the models filter?

Call the endpoint with group=pipeline_tag. Each returned id is a value for pipelineTag on the models search.

### Can I use dataset tag groups on models?

No. Each kind has its own groups, and a group from the other kind is refused with a 400.

### What is subGroup?

A finer grouping, for example nlp for a task tag. It can be null.

### How much does a tag list 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.