Skip to main content
Esta guía cubre los conceptos clave que necesitas para integrar los endpoints de Search Posts en tu aplicación.

Autenticación

Recent search admite múltiples métodos de autenticación: Full-archive search solo admite autenticación OAuth 2.0 App-Only.
Las métricas privadas (non_public_metrics, organic_metrics, promoted_metrics) no están disponibles con full-archive search porque solo admite autenticación App-Only.

Construcción de consultas

Las consultas usan operadores para coincidir con Posts. Combina operadores con lógica booleana:

Límites de longitud de consulta

Tipos de operadores

Construir una consulta

Aprende la sintaxis de consulta en detalle

Referencia de operadores

Consulta todos los operadores disponibles

Fields y expansions

Por defecto, la respuesta incluye solo id, text y edit_history_tweet_ids. Usa parámetros para solicitar datos adicionales.

Ejemplo de solicitud

cURL

Expansions disponibles

Guía de fields y expansions

Aprende más sobre cómo personalizar respuestas

Paginación

Los endpoints de search devuelven resultados en páginas. Usa el next_token de la respuesta para obtener páginas adicionales.

Cómo funciona

  1. Haz tu solicitud inicial con max_results
  2. Verifica el objeto meta para next_token
  3. Incluye next_token en solicitudes posteriores
  4. Repite hasta que no se devuelva ningún next_token

Ejemplo

cURL

Guía de paginación

Aprende más sobre paginación

Ediciones de Post

Los Posts pueden editarse hasta 5 veces dentro de los 30 minutos. Los endpoints de search siempre devuelven la versión más reciente.

Consideraciones

  • edit_history_tweet_ids contiene todos los IDs de Post (más antiguos primero)
  • Los Posts obtenidos después de la ventana de 30 minutos representan la versión final
  • Para casos de uso casi en tiempo real, los Posts publicados recientemente aún pueden editarse

Fundamentos de edición de Posts

Aprende más sobre las ediciones de Post

Mejores prácticas

Empieza específico

Usa múltiples operadores para reducir los resultados y disminuir el ruido.

Prueba de forma iterativa

Empieza amplio, luego refina según los resultados.

Maneja la paginación

Implementa una paginación adecuada para conjuntos de resultados grandes.

Cachea los resultados

Almacena los resultados localmente para evitar solicitudes repetidas.

Próximos pasos

Construir una consulta

Domina la sintaxis de consulta

Referencia de operadores

Todos los operadores disponibles

Paginación

Maneja conjuntos de resultados grandes

Referencia de la API

Documentación completa del endpoint