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.