Social Fetch
Start for freeStart free
Hugging Face hub

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Hugging Face Dataset Rows API 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.

Other Hugging Face endpoints