---
title: "Pagination"
url: "/help/buuk/guides/pagination"
updated: "2026-10-22T11:14:06.239Z"
---
# Pagination

`GET /api/public/articles` returns at most 100 items per request. Use `limit` and `offset` to walk the list.

## Response shape

```json
{
  "count": 10,
  "limit": 10,
  "offset": 0,
  "articles": [ /* ... */ ]
}
```

## Walking pages

1. **Start at offset 0**
   The first request omits offset or sets `offset=0`.

2. **Add limit each time**
   Next request uses `offset = previous offset + limit`.

3. **Stop when short**
   When `count` is less than `limit`, you have the last page.

> [!NOTE]
> Viewer tokens only see published articles, even if you pass status=draft.