> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zdlake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Traverse search results with opaque cursors.

Search endpoints use cursor pagination. Set `limit` from `1` to `100`; the default is `20`.

```json theme={null}
{
  "data": [],
  "_meta": {
    "total": 2242,
    "limit": 100,
    "current": {
      "cursor": null,
      "url": "https://api.zdlake.com/search"
    },
    "next": {
      "cursor": "opaque-cursor",
      "url": "https://api.zdlake.com/search?cursor=opaque-cursor"
    }
  }
}
```

`_meta.next` is `null` on the final page. Otherwise, POST the same JSON body to `_meta.next.url`.

```bash theme={null}
curl "https://api.zdlake.com/search?cursor=opaque-cursor" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "log4j",
    "where": {
      "logical_operator": "and",
      "conditions": [
        { "field": "cvss", "operator": "gte", "value": 7 }
      ]
    },
    "limit": 100,
    "sort": "epss",
    "order": "desc"
  }'
```

Treat the cursor as opaque. It is bound to the normalized query, sort, and order. Changing the request body while reusing a cursor returns `400 VALIDATION_ERROR`; begin a new traversal instead.

`total` is exact when the page is computed, but ingestion can change it during a long traversal.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.