> **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/datasets-owner-name-viewer>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hugging-face/datasets-owner-name-viewer.mdx>

---

# Hugging Face Dataset Rows Info API

Whether a dataset's rows can be shown, why they cannot, and the subsets, splits and columns behind them.

`GET /v1/hugging-face/datasets/{owner}/{name}/viewer` returns `lookupStatus` and `viewer`. `viewer.status` is `available` or `unavailable`, and `viewer.reason` says why when unavailable: `disabled`, `no_data_files`, `empty`, `unsupported_format`, `too_large` or `failed`.

When rows are available, `viewer` also carries `isPartial`, `supports` (`preview`, `viewer`, `search`, `filter`, `statistics`), `totalRows`, `parquetBytes` and `configs`. Each subset has `name`, `numRows`, `numColumns`, `license`, `homepage`, `features` and `splits`, and each split has `name`, `numRows` and `numBytes`.

## Request

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

## FAQ

### Why can rows not be shown for a dataset?

Read viewer.reason. The owner may have switched it off, the data files may be missing or empty, the format may be unsupported, the dataset may be too large, or preprocessing may have failed.

### How do I know which subset and split to request?

Read viewer.configs. Each subset lists its splits; pass the subset as config and the split as split to the rows and statistics endpoints.

### Is this the same as the dataset detail endpoint?

No. The detail endpoint returns the dataset record. This endpoint returns whether and how its rows are available.

### How much does a row facts lookup 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.