v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-05-271282305.2 KB

Filter rows of a split

Returns the rows matching the filter query, ordered by row index. Up to 100 rows are returned. The offset and length parameters allow to navigate the results.

get/filter

Query parameters

datasetstring required

The identifier of the dataset on the Hub.

configstring required

The dataset subset (also called 'configuration').

splitstring required

The split name.

wherestring required

The filter query.

offsetinteger

The offset of the returned rows.

lengthinteger

The maximum number of returned rows

Response

The <a href='https://huggingface.co/docs/datasets/about_dataset_features'>features</a>, and the list of rows that match the filter query. Bytes columns are not supported at the moment, and their content will be 'null'.

num_rows_totalinteger required
num_rows_per_pageinteger required
partialboolean required