Paginação
Cursores
Listas aceitam ?limit= e ?cursor= e respondem com um objeto meta ao lado dos dados:
GET /v1/events?limit=2
{
"events": [
{
"v": 1,
"t": "tweet.create",
"op": "create",
"id": "tweet:2097879002992070835",
"…": "…"
},
{
"v": 1,
"t": "follow.add",
"…": "…"
}
],
"meta": {
"count": 2,
"has_more": true,
"next_cursor": "eyJpZCI6MTAxODMyLCJ0IjoiMjAyNi0wOS0xNlQwODo0MDoxMSswMDowMCJ9"
}
}Passe next_cursor de volta como ?cursor= para a página seguinte; null significa o fim. Cursores são opacos e expiram junto com os dados para os quais apontam. Mais recentes primeiro para eventos, ordem alfabética para contas monitoradas. As leituras de listas de seguidores e de linha do tempo em Leituras usam os cursores do próprio X da mesma forma, e ali count é uma sugestão, não uma promessa — o X decide o tamanho da página e ignora valores pequenos rotineiramente, então um pedido de 5 pode retornar 70.