Skip to main content
La X API usa paginación para los endpoints que devuelven múltiples páginas de resultados (por ejemplo, timelines, búsqueda, etc.). Cada respuesta de la API incluye un objeto meta con result_count, previous_token y next_token. El XDK se encarga de realizar varias llamadas a la API usando el next_token para que los desarrolladores solo tengan que especificar cuántos datos buscan, sin necesidad de hacer varias llamadas. El SDK simplifica esto con:
  • Iteradores integrados: Usa funciones generadoras para obtener múltiples páginas sin fricción.
  • Manejo explícito de tokens: Para control manual y flexible cuando lo necesites, pasando pagination_token.
  • Aplicación de max results: Respeta max_results por llamada (hasta los límites de la API; por ejemplo, 100 para búsqueda).

Paginación automática (recomendada)

Usa el método iterate() en las respuestas paginadas para obtener todos los resultados de forma perezosa. Ejemplo: búsqueda paginada
Example
  • El iterador maneja next_token automáticamente.
  • Se detiene cuando no hay next_token.
  • Admite backoff por rate limit para evitar errores 429.

Paginación manual

Si necesitas controlar los resultados para alguna lógica personalizada (por ejemplo, procesar página por página), aún puedes usar el next_token y hacer la paginación manualmente como se muestra a continuación:
Example
Consejos:
  • Especifica siempre max_results para optimizar (el valor por defecto varía según el endpoint).
  • Monitorea meta.result_count para depurar.
  • Para consultas muy grandes, considera la iteración asíncrona para evitar bloqueos. Para ejemplos de código detallados usando el Python XDK, consulta nuestro repositorio de ejemplos de código en GitHub.