Pagination

Walk through long lists.

List endpoints take limit and offset query parameters and wrap results in items, with the total count in meta.

To read everything, increase offset by limit until it reaches meta.total. Most lists allow up to 100 items per page; each endpoint lists its own default and maximum.

List response

{
  "items": [
    "…"
  ],
  "meta": {
    "total": 134,
    "limit": 20,
    "offset": 40
  }
}

Fetch every page

let offset = 0;
const links = [];
while (true) {
  const res = await fetch(`https://api.clicklookup.com/v1/links?limit=100&offset=${offset}`, {
    headers: { Authorization: `Bearer ${process.env.CLICKLOOKUP_API_KEY}` },
  });
  const { items, meta } = await res.json();
  links.push(...items);
  offset += meta.limit;
  if (offset >= meta.total) break;
}