Pagination

Endpoints that support pagination usually offer offset-based or cursor-based pagination. See endpoint response format to determine what method to use.

Paginated responses contain a has_more boolean field, indicating whether or not there is more data available. Depending on method, the response will also have either a next_offset or cursor field. To fetch the next page of data, send the value of this field as an offset or cursor to the endpoint.

Example of an offset-based pagination

https://www.deviantart.com/api/v1/oauth2/browse/newest?limit=10&offset=20

{
    "has_more": true,
    "next_offset": 30,
    "results": [ ... ]
}

Some endpoints support bi-directional pagination, and provide additional prev_offset and has_less fields.

{
    "has_more": true,
    "next_offset": 30,
    "has_less": true,
    "prev_offset": 10,
    "results": [ ... ]
}

Example of a cursor-based pagination

https://www.deviantart.com/api/v1/oauth2/feed/notifications

{
    "cursor": "PTAmMz0wJxMj0wJjEzPTAmMTQ9MCYxNT0wJjE2PTAJjEwPTAmMTE9MCYc9MCYxOD0wJjE5PTAmMjA9MCYy",
    "has_more": false,
    "items": [ ... ]
}