Última actualización
Paginación
Las listas que pueden crecer sin límite se paginan con un cursor opaco. Pide un tamaño de página con limit y luego envía el nextCursor de cada página para obtener la siguiente.
Cursores
Una respuesta paginada incluye nextCursor. Envíalo de vuelta como el parámetro de consulta cursor para obtener la página siguiente; cuando es null no hay nada más antiguo. Las páginas van de la más reciente a la más antigua. Trata el cursor como opaco: su formato puede cambiar.
{ "data": { "items": [ … ], "nextCursor": "2026-10-31T07:51:44.935Z", "historyWindowDays": 365, "historyTruncated": false }}Cada lista define su propio rango de limit y su valor predeterminado; la referencia los muestra junto al parámetro. Cada página se cobra como una llamada.
Ventana de historial
El historial registrado está limitado por el plan. historyWindowDays indica hasta dónde puede leer el espacio de trabajo, y historyTruncated: true significa que existen datos más antiguos, pero quedan fuera de esa ventana.
limit cuando corresponde, pero no un cursor.Lee todas las páginas
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);