A slice of rows of a split

Changed on

The list of rows of a dataset split at a given slice location (offset). Up to 100 rows are returned, use the length parameter to get less.

get/rows

Request

  • Base URL
    https://datasets-server.huggingface.co
  • URL
    https://datasets-server.huggingface.co/rows
  • Auth
    • none
    • or HTTP bearer
    • or HTTP bearer

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.

offsetinteger

The offset of the slice.

lengthinteger

The length of the slice

Response

The <a href='https://huggingface.co/docs/datasets/about_dataset_features'>features</a>, and the list of rows of the requested slice. 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

Changes

    • breaking

      added to the /// response property oneOf list for the response status

    • breaking

      added to the // response property oneOf list for the response status

    • breaking

      added to the // response property oneOf list for the response status

    • breaking

      the ////// response's property type changed from array to object for status

    • info

      added the required property /////// to the response with the status

    • info

      added the required property /////// to the response with the status