Bahasa Indonesia
Get an API key

Concepts

Pages and cursors

How to read a long list all the way to the end.

Lists are returned one page at a time. Use limit up to 100, the default is 50. When has_more is true, send next_cursor as cursor in the next request.

Two pages in a row
GET /v1/campaigns/abc123/content?limit=100
GET /v1/campaigns/abc123/content?limit=100&cursor=eyJhIjoi...
End of every list
{
  "object": "list",
  "data": [],
  "has_more": true,
  "next_cursor": "eyJhIjoi...",
  "as_of": "2026-11-02T09:00:00.000Z"
}

Rules

  • A page can hold fewer rows than limit, or even none. Only has_more tells you that you are done.
  • Treat the cursor as opaque text.
  • A cursor only works with the same key and the same list.
  • List order is stable, but it does not follow dates. Sort on your side if you need to.

Example

import os, requests

API = "https://api.wefluence.app/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['WEFLUENCE_API_KEY']}"}

def get_all(path, **params):
    while True:
        page = requests.get(f"{API}{path}", headers=HEADERS, params=params).json()
        yield from page["data"]
        if not page["has_more"]:
            return
        params["cursor"] = page["next_cursor"]
const API = "https://api.wefluence.app/v1";
const headers = { Authorization: `Bearer ${process.env.WEFLUENCE_API_KEY}` };

async function* getAll(path, params = {}) {
  while (true) {
    const qs = new URLSearchParams(params);
    const page = await (await fetch(`${API}${path}?${qs}`, { headers })).json();
    yield* page.data;
    if (!page.has_more) return;
    params.cursor = page.next_cursor;
  }
}