Passer au contenu principal
Le groupe d’endpoints du flux filtré permet aux développeurs de filtrer un flux continu de Posts publics. Les fonctionnalités de ce groupe incluent plusieurs endpoints qui vous permettent de créer et de gérer des règles, puis d’appliquer ces règles pour filtrer un flux de Posts et renvoyer les Posts publics correspondants. Ce groupe d’endpoints permet aux utilisateurs d’écouter des sujets et des événements précis, de surveiller la conversation autour de compétitions, de comprendre comment les tendances se développent, et bien plus encore. Les développeurs peuvent utiliser l’endpoint REST rules pour ajouter et supprimer des règles sur une connexion de flux persistante sans devoir se déconnecter. Ces règles peuvent être créées avec des opérateurs correspondant à des attributs de Post tels que des mots-clés, des hashtags et des URL. Les opérateurs et les clauses de règle peuvent être combinés avec une logique booléenne et des parenthèses pour affiner le comportement de mise en correspondance du filtre. Une fois que vous avez ajouté un ensemble de règles, vous pouvez établir une connexion de streaming qui commencera à livrer des Objets Post au format JSON via une connexion HTTP Streaming persistante. Vous ne recevrez que le contenu correspondant à vos règles tant que vous êtes connecté au flux. Vous pouvez également lier le Filtered Stream à un webhook pour une livraison sous forme d’événements webhook. Pour plus de détails sur l’utilisation des webhooks avec Filtered Stream, consultez l’introduction aux webhooks Filtered Stream. L’endpoint de recherche filtrée prend en charge les Posts modifiés. Cet endpoint livrera les Posts modifiés qui correspondent à un ou plusieurs de vos filtres, ainsi que leur historique des modifications, incluant un tableau d’ID de Post. Pour les Posts sans historique de modification, ce tableau contiendra un seul ID. Pour les Posts qui ont été modifiés, ce tableau contient plusieurs ID, classés par ordre croissant reflétant la chronologie des modifications, la version la plus récente occupant la dernière position du tableau. Pour en savoir plus sur le fonctionnement des modifications de Posts, consultez la page Fondamentaux des éditions de Posts. Certains aspects de l’endpoint de flux filtré sont limités par le niveau d’accès : Accès Pro
  • 1000 règles par projet
  • 100 requêtes par tranches de 15 minutes lors de l’utilisation de l’endpoint POST /2/tweets/search/stream/rules pour ajouter des règles
  • Possibilité d’utiliser tous les opérateurs lors de la création de votre règle
  • Possibilité de créer des règles jusqu’à 1024 caractères
Accès Enterprise
  • 25 000+ règles par projet
  • Possibilité d’utiliser tous les opérateurs lors de la création de votre règle
  • Possibilité de créer des règles jusqu’à 2048 caractères
  • Postulez ici pour un accès Enterprise
Les Posts renvoyés par le flux filtré sont comptabilisés dans le Post cap mensuel.
Configuration du comptePour accéder à ces endpoints, vous aurez besoin de :Pour en savoir plus sur l’accès aux endpoints X API v2, consultez notre guide de démarrage.
⌘I