Skip to main content
Los endpoints de Filtered Stream te permiten recibir Posts casi en tiempo real que coincidan con tus reglas de filtrado. Crea reglas usando operadores potentes y luego conéctate a un stream persistente para recibir Posts coincidentes a medida que se publican.
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

  1. Crear reglas — define reglas de filtrado usando operadores
  2. Conectarse al stream — establece una conexión HTTP persistente
  3. 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

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