| name | hugging-face-dataset-viewer |
| description | Query Hugging Face datasets through the Dataset Viewer API for splits, rows, search, filters, and parquet links. |
| type | skill |
| created | 2026-02-27T00:00:00.000Z |
| domain | ai-ml |
| category | llm-agents |
| risk | unknown |
| source | https://github.com/huggingface/skills/tree/main/skills/huggingface-datasets |
| tags | ["skill","ai-ml","llm-agents","hugging","face","dataset"] |
Hugging Face Dataset Viewer
When to Use
Use this skill when you need read-only exploration of a Hugging Face dataset through the Dataset Viewer API.
Use this skill to execute read-only Dataset Viewer API calls for dataset exploration and extraction.
Core workflow
- Optionally validate dataset availability with
/is-valid.
- Resolve
config + split with /splits.
- Preview with
/first-rows.
- Paginate content with
/rows using offset and length (max 100).
- Use
/search for text matching and /filter for row predicates.
- Retrieve parquet links via
/parquet and totals/metadata via /size and /statistics.
Defaults
- Base URL:
https://datasets-server.huggingface.co
- Default API method:
GET
- Query params should be URL-encoded.
offset is 0-based.
length max is usually 100 for row-like endpoints.
- Gated/private datasets require
Authorization: Bearer <HF_TOKEN>.
Dataset Viewer
Validate dataset: /is-valid?dataset=<namespace/repo>
List subsets and splits: /splits?dataset=<namespace/repo>
Preview first rows: /first-rows?dataset=<namespace/repo>&config=<config>&split=<split>
Paginate rows: /rows?dataset=<namespace/repo>&config=<config>&split=<split>&offset=<int>&length=<int>
Search text: /search?dataset=<namespace/repo>&config=<config>&split=<split>&query=<text>&offset=<int>&length=<int>
Filter with predicates: /filter?dataset=<namespace/repo>&config=<config>&split=<split>&where=<predicate>&orderby=<sort>&offset=<int>&length=<int>
List parquet shards: /parquet?dataset=<namespace/repo>
Get size totals: