Pagination

To efficiently handle large datasets, the Storyblok API supports pagination for all top-level resources, such as Stories, Links, and Datasource Entries.

The list API method allows two parameters, page and per_page:

Query parameter	Description
page	An integer value representing the page number to retrieve. Increase this value to receive the next page of entries. The default is set to 1.
per_page	The number of entries per page. The default is set to 25, the maximum is 100 (1000 for datasource entries).

Note

For paginated API requests, the response headers include two important properties:

• total: Indicates the total number of items available across all pages.

• per_page: Specifies the number of items per page as per your request.

These values can be leveraged to implement efficient pagination strategies.

Tip

Requesting a page number that is higher than the last available page number results in an empty array in the API response.

Related resources

How to generate a sitemap