Saltar al contenido principal
El grupo de endpoints de stream filtrado permite a los desarrolladores filtrar un stream de Posts públicos. La funcionalidad de este grupo de endpoints incluye varios endpoints que permiten crear y administrar reglas, y aplicar esas reglas para filtrar un stream de Posts que devolverá Posts públicos que coincidan. Este grupo de endpoints permite a los usuarios escuchar 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 endpoint de reglas REST para agregar y eliminar reglas en una conexión de stream persistente sin necesidad de desconectarse. Estas reglas pueden crearse con operadores que hagan coincidir atributos del Post como palabras clave, hashtags y URL. Los operadores y las cláusulas de regla pueden combinarse con lógica booleana y paréntesis para ayudar a refinar el comportamiento de coincidencia del filtro. Una vez que hayas agregado un conjunto de reglas, puedes establecer una conexión de streaming que comenzará a entregar Objetos de Post en formato JSON a través de una conexión de streaming HTTP persistente. Solo recibirás contenido que coincida con tus reglas mientras estés conectado al stream. Como alternativa, puedes vincular el Filtered Stream a un webhook para la entrega como eventos de webhook. Para más detalles sobre el uso de webhooks con Filtered Stream, consulta la introducción a los webhooks de Filtered Stream. El endpoint de búsqueda filtrada admite Posts editados. Este endpoint entregará Posts editados que coincidan con uno o más de tus filtros, junto con su historial de edición, incluido un arreglo de IDs de Post. Para los Posts sin historial de edición, este arreglo contendrá un único ID. Para los Posts que han sido editados, este arreglo contiene múltiples IDs, organizados en orden ascendente que refleja 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 Post, consulta la página Fundamentos de ediciones de Posts. Ciertos aspectos del endpoint de stream filtrado están limitados por el nivel de acceso: Acceso Pro
  • 1000 reglas por proyecto
  • 100 solicitudes por 15 minutos al usar el endpoint POST /2/tweets/search/stream/rules para agregar reglas
  • Puede usar todos los operadores al crear su regla
  • Puede crear reglas de hasta 1024 caracteres de longitud
Acceso Enterprise
  • 25,000+ reglas por proyecto
  • Puede usar todos los operadores al crear su regla
  • Puede crear reglas de hasta 2048 caracteres de longitud
  • Solicita aquí el acceso Enterprise
Los Posts devueltos desde el stream filtrado cuentan para el Post cap mensual.
Configuración de la cuentaPara acceder a estos endpoints, necesitarás:Obtén más información sobre cómo acceder a los endpoints de X API v2 en nuestra guía de inicio.
⌘I