Skip to main content
A X API usa paginação para endpoints que retornam múltiplas páginas de resultados (por exemplo, timelines, pesquisa etc.). Cada resposta de chamada de API inclui um objeto meta com result_count, previous_token e next_token. O XDK cuida de fazer múltiplas chamadas de API usando o next_token, para que os desenvolvedores possam apenas especificar quanto dados desejam sem precisar fazer múltiplas chamadas. O SDK simplifica isso com:
  • Iteradores integrados: Use funções geradoras para busca contínua de múltiplas páginas.
  • Tratamento explícito de tokens: Para controle manual flexível quando necessário, passando pagination_token conforme apropriado.
  • Aplicação de Max Results: Respeita max_results por chamada (até os limites da API, por exemplo, 100 para pesquisa).

Paginação automática (recomendado)

Use o método iterate() em respostas paginadas para buscar todos os resultados de forma preguiçosa. Exemplo: pesquisa paginada
Example
  • O iterador trata next_token automaticamente.
  • Para quando não há um next_token presente.
  • Suporta backoff de limite de taxa para evitar erros 429.

Paginação manual

Se você precisar controlar os resultados para alguma lógica personalizada (por exemplo, processando página por página), ainda pode usar o next_token e fazer a paginação manualmente, como mostrado abaixo:
Example
Dicas:
  • Sempre especifique max_results para otimizar (o padrão varia por endpoint).
  • Monitore meta.result_count para depuração.
  • Para consultas muito grandes, considere iteração assíncrona para evitar bloqueios. Para exemplos de código detalhados usando o XDK Python, confira nosso repositório de exemplos de código no GitHub.