Passer au contenu principal
Les endpoints de flux filtrés renvoient des Publications qui correspondent à un ensemble de règles appliquées au flux. Les règles sont composées d’opérateurs qui correspondent à différents attributs de Publication. Plusieurs règles peuvent être appliquées à l’aide de l’endpoint POST /tweets/search/stream/rules. Une fois que vous avez ajouté des règles et établi une connexion via GET /tweets/search/stream, seules les Publications correspondant à vos règles seront renvoyées. Il n’est pas nécessaire de vous déconnecter pour ajouter ou supprimer des règles.

Limites des règles

Les limites concernant le nombre de règles dépendent de votre niveau d’accès. Consultez l’introduction au flux filtré pour connaître les limites spécifiques.

Types d’opérateurs : autonomes et nécessitant une conjonction

Les opérateurs autonomes peuvent être utilisés seuls ou avec n’importe quel autre opérateur (y compris ceux qui nécessitent une conjonction). Par exemple, cette règle fonctionne parce que #hashtag est un opérateur autonome :
Les opérateurs nécessitant une conjonction ne peuvent pas être utilisés seuls dans une règle ; ils ne peuvent être utilisés que lorsqu’au moins un opérateur autonome est inclus. En effet, utiliser uniquement ces opérateurs renverrait un volume extrêmement élevé de Publications. Par exemple, les règles suivantes ne sont pas prises en charge puisqu’elles ne contiennent que des opérateurs nécessitant une conjonction :
Si nous ajoutons un opérateur isolé, comme l’expression "X data", la règle fonctionne correctement :

Opérateurs booléens et regroupement

Enchaînez plusieurs opérateurs à l’aide de ces outils :
Remarque sur les négations
  • Tous les opérateurs peuvent être niés, sauf sample:
  • L’opérateur -is:nullcast doit toujours être nié
  • Les opérateurs niés ne peuvent pas être utilisés seuls
  • Ne niez pas les opérateurs regroupés. Au lieu de skiing -(snow OR day OR noschool), utilisez skiing -snow -day -noschool

Ordre des opérations

Lorsque vous combinez AND et OR :
  1. Les opérateurs liés par l’opérateur logique AND sont d’abord combinés
  2. Puis, les opérateurs liés par l’opérateur logique OR sont appliqués
Exemples : Pour éliminer toute incertitude, utilisez des parenthèses :

Ponctuation, signes diacritiques et sensibilité à la casse

Signes diacritiques : les règles de flux filtré contenant des accents ne font correspondre que les Publications qui contiennent également l’accent. Par exemple, diacrítica correspond à diacrítica mais pas à diacritica. Sensibilité à la casse : tous les opérateurs sont insensibles à la casse. La règle cat correspond à cat, CAT et Cat.
La recherche de Publications se comporte différemmentLors de la création de requêtes de recherche, les mots-clés avec accents correspondent aux Publications avec et sans accents. Par exemple, Diacrítica correspond à la fois à Diacrítica et Diacritica.

Correspondance des Quote Tweets

Lorsque vous utilisez le flux filtré, les opérateurs effectuent la correspondance à la fois sur le contenu du Quote Tweet et sur le contenu de la Publication originale qui a été citée.
Rechercher des Publications se comporte différemment — il ne fait correspondre que le contenu du Quote Tweet, et non celui de la Publication originale.

Spécificité et efficacité

L’utilisation d’opérateurs trop généraux, comme un seul mot-clé ou hashtag, n’est pas recommandée : ils correspondent à un volume massif de Publications et épuiseront rapidement votre connexion.
Conseils pour créer des règles efficaces :
  1. Commencez avec des critères précis, puis élargissez — Créez des règles ciblées qui renvoient des résultats pertinents
  2. Utilisez plusieurs opérateurs — Combinez des opérateurs pour affiner les résultats
  3. Surveillez votre nombre de caractères — L’ensemble de la chaîne de la règle est pris en compte dans cette limite
Exemple de progression :

Construire une règle de manière itérative

Étape 1 : Commencez par une règle de base

Étape 2 : Tester et affiner en fonction des résultats

Nous avons observé des Publications dans de nombreuses langues. Ajoutez un filtre de langue :
On reçoit des vœux d’anniversaire. Excluez-les, ainsi que les Retweets :

Étape 3 : élargir pour une meilleure couverture

Nous voulons couvrir un éventail plus large de sentiments. Ajoutez des mots-clés connexes :
Des Publications liées aux fêtes apparaissent. Excluez-les :

Ajout et suppression de règles

Utilisez POST /2/tweets/search/stream/rules pour ajouter ou supprimer des règles.

Ajout de règles

Envoyez un corps JSON add avec la propriété value (la règle) et, de manière facultative, tag (pour identifier les Publications correspondantes) :

Suppression de règles

Soumettez un corps de requête JSON delete avec les id des règles à supprimer :

Exemples de règles

Suivi d’une catastrophe naturelle

Faites correspondre les Publications d’agences météorologiques concernant l’ouragan Harvey :

Analyse des sentiments pour #nowplaying

Sentiment positif :
Sentiment négatif :

Utiliser les annotations de Publication

Trouvez des Publications en japonais à propos d’animaux de compagnie (hors chats) avec des images en utilisant l’opérateur context: : Commencez par utiliser la consultation de Publication avec tweet.fields=context_annotations pour identifier les ID domain.entity :
  • Chats : domain 66, entity 852262932607926273
  • Animaux de compagnie : domain 65, entity 852262932607926273

Prochaines étapes

Référence des opérateurs

Liste complète des opérateurs disponibles

Démarrage rapide du flux filtré

Connectez-vous à votre flux

Exemples de code

Exemples de code dans plusieurs langages