List Hugging Face dataset rows
List rows from a Hugging Face dataset a page at a time.
Headers
Get your API keyAPI key (`sfk_...`)
Owner of the repository: a user or organization name.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
Repository name, without the owner.
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,95}$
Subset (config) name, e.g. `plain_text`. Default: the dataset's first subset. An unknown name is refused with a 400.
min 1 chars · max 200 chars
Split name, e.g. `train`. Default: the subset's first split. An unknown name is refused with a 400.
min 1 chars · max 200 chars
Page number (1-based), `limit` rows a page. Default: 1.
≥ 1 · ≤ 1000000
Items per page, 1-100. A page can hold fewer. Default: 20.
≥ 1 · ≤ 100
Endpoint-specific response payload.
Whether the item was found. `restricted` means it exists but its content is gated.
one of: found, not_found, restricted
`available` when Hugging Face can show the dataset's rows; `unavailable` when it cannot.
one of: available, unavailable
Why no rows are shown: `disabled` (the owner switched it off), `no_data_files`, `empty`, `unsupported_format`, `too_large`, `failed`, or `split_not_found` when a default lookup finds no split in the dataset. Null when rows are available. A `config` or `split` you name that the dataset does not have is refused with a 400.
one of: disabled, no_data_files, empty, unsupported_format, too_large, failed, split_not_found, null
Subset the rows are from.
Split the rows are from.
Rows in the split.
Columns of the split.
Column name.
Column type, e.g. `string`, `int64`, `ClassLabel`, `Image`.
Rows on this page.
Row number within the split, from 0.
Column values. Images and audio are links to files Hugging Face hosts.
Columns whose long values were cut short.
Whether the split is only partly available.
Pagination state.
Offset of the first row.
Whether more rows follow.
Page number to pass as `page` for the next page; null on the last page.
Offset of the next page's first row; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/hugging-face/datasets/stanfordnlp/imdb/rows?limit=5" \
-H "x-api-key: YOUR_API_KEY"Responses
Dataset rows page.