Filtered Stream prioriza la hidratación y entrega de datos, con aproximadamente 6-7 segundos de latencia P99. Para requisitos de latencia más baja, consulta Powerstream.
Descripción general
Entrega casi en tiempo real
Recibe Posts en segundos tras su publicación
Reglas persistentes
Añade y elimina reglas sin desconectarte
Operadores potentes
Coincide con palabras clave, hashtags, usuarios y más
Entrega por webhook
Opcionalmente recibe Posts a través de webhooks
Cómo funciona
- Crear reglas — define reglas de filtrado usando operadores
- Conectarse al stream — establece una conexión HTTP persistente
- Recibir Posts — obtén Posts coincidentes casi en tiempo real
Endpoints
Niveles de acceso
Contáctanos para Enterprise
Obtén límites más altos y funciones adicionales
Algunos operadores requieren niveles específicos. El operador semántico
embedding: está disponible solo para Filtered Stream en planes Enterprise con acceso al Embedding tier. El acceso Pay-per-use estándar incluye solo operadores core.Construir reglas
Las reglas usan los mismos operadores que las consultas de búsqueda:Ejemplos de reglas
Construir una regla
Aprende la sintaxis y los operadores de las reglas
Conectarse al stream
Establece una conexión HTTP persistente para recibir Posts:Señales de keep-alive
El stream envía líneas en blanco (\r\n) cada 20 segundos para mantener la conexión. Si no recibes datos o un keep-alive durante 20 segundos, vuelve a conectarte.
Manejo de desconexiones
Reconéctate de forma controlada
Consumo de datos en streaming
Procesa Posts de forma eficiente
Entrega por webhook
En lugar de mantener una conexión persistente, puedes recibir Posts a través de webhooks:Entrega por webhook
Configura la entrega por webhook para filtered stream
Ediciones de Post
El stream entrega Posts editados con su historial de edición. Cada edición crea un nuevo ID de Post:Fundamentos de edición de Posts
Aprende más sobre las ediciones de Posts
Cómo empezar
Requisitos previos
- Una cuenta de desarrollador aprobada
- Un Project y App en la Developer Console
- El Bearer Token de tu App
Quickstart
Conéctate al stream en minutos
Construir una regla
Aprende la sintaxis de las reglas
Referencia de operadores
Todos los operadores disponibles
Código de ejemplo
Ejemplos de código funcional
Temas avanzados
Manejo de desconexiones
Reconéctate de forma controlada
Capacidad de alto volumen
Maneja un alto rendimiento
Recuperación y redundancia
Construye aplicaciones resilientes
Coincidencia de Posts devueltos
Identifica qué reglas coincidieron