최종 업데이트 2026년 11월 1일

페이지네이션

끝없이 늘어날 수 있는 목록은 불투명한 커서로 페이지를 나눕니다. limit으로 페이지 크기를 지정한 다음, 각 페이지의 nextCursor를 전달해 다음 페이지를 가져오세요.

커서

페이지 단위 응답에는 nextCursor가 포함됩니다. 다음 페이지를 받으려면 이 값을 cursor 쿼리 파라미터로 다시 보내세요. 값이 null이면 더 오래된 데이터가 없습니다. 페이지는 최신순입니다. 커서는 형식이 바뀔 수 있으므로 불투명한 값으로 다루세요.

GET /v1/live/sessions?limit=100

{  "data": {    "items": [ … ],    "nextCursor": "2026-10-31T07:51:44.935Z",    "historyWindowDays": 365,    "historyTruncated": false  }}

목록마다 limit의 범위와 기본값이 다르며, 레퍼런스의 파라미터 옆에 표시됩니다. 각 페이지는 호출 한 번으로 과금됩니다.

기록 보관 기간

기록된 데이터의 조회 범위는 요금제에 따라 제한됩니다. historyWindowDays는 워크스페이스가 얼마나 과거까지 조회할 수 있는지 나타내며, historyTruncated: true는 더 오래된 데이터가 있지만 그 기간 밖에 있다는 뜻입니다.

짧은 목록은 페이지를 나누지 않습니다

랭킹 보드, 지역, 알림 규칙, 내보내기는 전체가 한 번에 반환됩니다. 해당되는 경우 limit은 받지만 커서는 사용하지 않습니다.

모든 페이지 읽기

let cursor = null;const sessions = [];do {  const params = new URLSearchParams({ limit: "100", ...(cursor ? { cursor } : {}) });  const res = await fetch(`https://api.toktokdata.live/v1/live/sessions?${params}`, {    headers: { Authorization: `Bearer ${process.env.ROOMSCOPE_API_KEY}` },  });  const { data } = await res.json();  sessions.push(...data.items);  cursor = data.nextCursor;} while (cursor);

이 페이지가 도움이 되었나요?