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

---

# Hugging Face Dataset Rows API

A page of dataset rows with typed columns, row indexes and the page number.

`GET /v1/hugging-face/datasets/{owner}/{name}/rows` returns `viewerStatus`, `reason`, `config`, `split`, `totalRows`, `columns`, `rows`, `isPartial` and a `page` block. Choose `config` and `split` from the row facts endpoint, and `page` plus `limit` (up to 100, default 20) for the page. A `config` or `split` the dataset does not have is refused with a 400.

Each row has `index` within the split, `values` keyed by column name, and `truncatedColumns` for long values that were cut short. Images and audio in `values` are links the platform hosts. Pass `page.nextPage` as `page` while `page.hasMore` is true; `page.nextOffset` reports the next page's first row.

## Request

- **Endpoint:** `GET /v1/hugging-face/datasets/{owner}/{name}/rows`
- **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/rows/get)
- **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face)

## FAQ

### How do I choose config and split?

Read the row facts endpoint first. It lists each subset and its splits; the defaults are the dataset's first subset and that subset's first split.

### Why is the rows list empty?

A page past the end returns an empty page. A dataset whose rows cannot be shown returns viewerStatus unavailable with a reason. A config or split the dataset does not have is refused with a 400; read the row facts endpoint to list the valid names.

### What are truncatedColumns?

Columns whose long values were cut short in the response. The list names them so you know the value is incomplete.

### How much does a row page 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. Each paginated page is a separate billed request.