Saltar al contenido principal
El grupo de endpoints de flujo filtrado permite a los desarrolladores filtrar un flujo de Posts públicos. La funcionalidad de este grupo incluye varios endpoints que permiten crear y administrar reglas, y aplicarlas para filtrar un flujo de Posts que devolverá los Posts públicos que coincidan. Este grupo permite a los usuarios seguir temas y eventos específicos, monitorear la conversación en torno a competiciones, comprender cómo se desarrollan las tendencias y mucho más. Los desarrolladores pueden usar el REST endpoint de reglas para agregar y eliminar reglas en una conexión de flujo persistente sin necesidad de desconectarse. Estas reglas se pueden crear con operadores que hacen coincidir atributos del Post como palabras clave, hashtags y URL. Los operadores y las cláusulas de reglas se pueden combinar con lógica booleana y paréntesis para afinar el comportamiento de coincidencia del filtro. Una vez que hayas agregado un conjunto de reglas, puedes establecer una conexión de streaming que empezará a entregar objetos Post en formato JSON a través de una conexión HTTP Streaming persistente. Solo recibirás contenido que coincida con tus reglas mientras estés conectado al flujo. Como alternativa, puedes vincular el flujo filtrado a un webhook para la entrega como eventos de webhook. Para más detalles sobre cómo usar webhooks con flujo filtrado, consulta la introducción a webhooks de flujo filtrado. El endpoint de búsqueda filtrada es compatible con Posts editados. Este endpoint entregará Posts editados que coincidan con uno o más de tus filtros, junto con su historial de ediciones, incluido un arreglo de IDs de Post. Para Posts sin historial de ediciones, este arreglo contendrá un único ID. Para Posts que han sido editados, este arreglo contiene múltiples IDs, ordenados de forma ascendente según el orden de las ediciones, con la versión más reciente en la última posición del arreglo. Para obtener más información sobre cómo funcionan las ediciones de Posts, consulta la página Fundamentos de las ediciones de Posts. Ciertos aspectos del endpoint de flujo filtrado están limitados por el nivel de acceso: Acceso Pro
  • 1000 reglas por proyecto
  • 100 solicitudes por cada 15 minutos al usar el endpoint POST /2/tweets/search/stream/rules para agregar reglas
  • Puedes usar todos los operadores al crear tu regla
  • Puedes crear reglas de hasta 1024 caracteres
Acceso Empresarial
  • 25,000+ reglas por proyecto
  • Puedes usar todos los operadores al crear tu regla
  • Puedes crear reglas de hasta 2048 caracteres
  • Solicita aquí el acceso Empresarial
Los Posts devueltos por el flujo filtrado cuentan para el límite mensual de Posts.
Configuración de la cuentaPara acceder a estos endpoints, necesitarás:Obtén más información sobre cómo obtener acceso a los endpoints de X API v2 en nuestra guía de introducción.