Liste des opérateurs
Liste complète des opérateurs disponibles dans la création de Topic
Grammaire
L'ensemble des opérateurs booléens logiques ET, OU, EXCLUSION et PARENTHESES sont disponibles au sein d'une même ligne :
- Un espace entre 2 mots ou opérateurs correspond au "ET" logique.
- L'opérateur OR écrit en majuscule entre deux mots correspond au "OU" logique.
- Le signe moins - (sans espace après, mais avec un espace avant) correspond à l'exclusion.
- Les parenthèses () peuvent être utilisées pour faire des regroupements. Par défaut le ET (espace) est prioritaire sur le OU (OR).
Chaque ligne est indépendante (une nouvelle ligne est l'équivalent d'un OR avec parenthèses autour de la ligne).
L'ensemble des opérateurs ci-dessous peuvent se combiner entre eux et avec l'ensemble des opérateurs booléens ET, OU, EXCLUSION et PARENTHESES.
Opérateurs sur le contenu
| Opérateur | Explication | Exemple |
|---|---|---|
| mot-clé | Capte toutes les publications contenant le mot-clé, ou le mot-clé avec un # devant (hashtag). | voiture Capte l'ensemble des publications avec le mot-clé "voiture" ou le hashtag #voiture |
| "expression exacte" | Capte toutes les publications contenant l'expression exacte, c'est à dire l'ensemble des mots de l'expression, dans cet ordre précis. | "voiture bleue" Capte l'ensemble des publications avec l'expression-clé "voiture bleue" dedans. Ne capte PAS le contenu suivant : automobile bleue et voiture jaune. |
| #hashtag | Capte toutes les publications contenant le hashtag. | #voiture Capte l'ensemble des publications avec le hashtag #voiture dedans. Ne capte PAS les publications avec le mot-clé "voiture", sans #. |
| emoji | Capte toutes les publications contenant un emoji spécifique. | 😂 Capte l'ensemble des publications contenant l'emoji "joy". |
| contains:élément | Capte toutes les publications contenant la chaine de caractère "élément", y compris à l'intérieur d'un mot. Opérateur non disponible pour la récupération rétroactive de données. | contains:compte Capte : compte, compteur, comptes, compter, comptez... Mais également acompte, recompte, recomptez, escompter.. |
| lang:XX | Permet de ne prendre en compe que les publications dans une langue en particulier. XX = abbréviation de la langue Les langues principales : fr (français), en (anglais), es (espagnol), ja (japonais) Voir la liste des 64 langues disponibles | moto lang:fr Capte l'ensemble des publications francophones avec le mot-clé "moto" dedans. Ne capte aucune publication en langue anglaise, japonaise... |
Il n'est pas nécessaire de se préoccuper des majuscules
Il n'y a pas besoin de mettre les différentes variantes avec et sans majuscule : Visibrain prend automatiquement en compte toutes les variantes de casse.
Mettre les variantes avec et sans accent
A l'inverse, il faut penser à lister les différentes variantes d'accentuation (é, à, ç, û, ï...). En effet, Visibrain considère un mot accentué comme différent.
Opérateurs sur les comptes Twitter
| Opérateur | Explication | Exemple |
|---|---|---|
| from:utilisateur | Capte toute l'activité du compte Twitter @utilisateur | from:lemondefr Capte quand @lemondefr écrit un tweet, ou quand @lemondefr retweete un autre compte. Ne capte PAS quand un autre compte retweete @lemondefr. |
| retweets_of:utilisateur | Capte les retweets (faits par d'autres comptes) des tweets écrits par @utilisateur. | retweets_of:lemondefr Capte quand @journaliste1 retweete un tweet de @lemondefr. Ne capte PAS le tweet initial de @lemondefr. |
| @utilisateur | Capte quand un tweet mentionne @utilisateur | @bouyguestelecom Capte quand un utilisateur écrit un tweet "J'ai un nouveau forfait @bouyguestelecom" ou "@bouyguestelecom j'ai une question sur mon forfait". Ne capte PAS les tweets de @bouyguestelecom. |
| to:utilisateur | Capte les réponses adressées à l'utilisateur @utilisateur | to:LDLC Captera les réponses à tous les tweets de @LDLC, et également tous les tweets commençant par "@LDLC...". Ne capte PAS les tweets de @LDLC. |
Ne pas mettre le @ dans les règles from: et retweets_of:
Les règles from: et retweets_of: s'utilisent sans le @ du nom d'utilisateur.
Si vous mettez les @, votre règle ne marchera pas.
Ne pas oublier l'opérateur from:utilisateur
Les opérateurs retweets_of:utilisateur, @utilisateur ou to:utilisateur utilisés seuls ne capteront pas les tweets écrits par @utilisateur, ce qui peut aboutir à des comportements étranges dans la plateforme par la suite.
Nous vous recommandons de toujours les utiliser conjointement avec l'opérateur from:, par exemple :
from:utilisateur
retweets_of:utilisateur
Opérateur sur les contenus web (articles, photos, vidéos)
| Opérateur | Explication | Exemple |
|---|---|---|
| url:mot-clé url:"expression-exacte" | Capte tous les contenus web dont l'URL contient le mot-clé (ou l'expression-clé). | url:"lemonde.fr" Capte toutes les publications du site lemonde.fr |
| url_title:mot-clé url_title:"expression exacte" | Capte tous les contenus web dont le titre contient le mot-clé (ou l'expression-clé). Opérateur non disponible pour la récupération rétroactive de données. | url_title:"Breaking News" Capte toutes les publications intitulées "Breaking News" (expression exacte). url_title:Breaking url_title:News Capte toutes les publications contenant les mots-clés Breaking et News dans leur titre (quel que soit l'ordre des mots-clés). |
| url_description:mot-clé url_description:"expression exacte" | Capte tous les contenus web dont le corps contient le mot-clé (ou l'expression-clé). Opérateur non disponible pour la récupération rétroactive de données. | url_description:Amazon Capte tous les articles contenant "Amazon" dans leur chapeau, et toutes les vidéos YouTube contenant "Amazon" dans leur description. |
Les opérateurs url_title: et url_description: ne fonctionnent pas rétroactivement
Il n'est pour l'instant pas possible de récupérer des données de manière rétroactive sur les opérateurs url_title: et url_description:.
Dans un premier temps, vous pouvez créer dans un Topic sans ces opérateurs pour récupérer les données rétroactivement, puis les rajouter en éditant le Topic par la suite.
Opérateurs sur les profils Twitter
| Opérateur | Explication | Exemple |
|---|---|---|
| bio:mot-clé bio:"expression exacte" | Capte tous les tweets des comptes dont la biographie contient le mot-clé ou l'expression exacte. Opérateur non disponible pour la récupération rétroactive de données. | bio:journaliste Capte tous les tweets des comptes qui se sont déclarés comme journalistes dans leur biographie. (Ne capte PAS "journalist" ou "journalistes") |
| bio_name:mot-clé bio_name:"expression exacte" | Capte tous les tweets des comptes dont le nom complet contient le mot-clé ou l'expression exacte. Opérateur non disponible pour la récupération rétroactive de données. | bio_name:"France 3" Capte tous les tweets ayant "France 3" dans leur nom complet (ex : @France3tv , @F3Rhone_Alpes...) |
| profile_country:XX | Capte tous les tweets des comptes ayant été identifiés comme étant d'un certain pays grâce au champs "Localisation". XX = abbréviation du pays Liste des pays disponibles | accident profile_country:fr Capte tous les tweets contenant le mot-clé "accident", écrits par des comptes identifiés comme en France, par exemple parce que le champs "Localisation" de leur biographie contient "Toulouse", ou "Rhônes-Alpes". |
| profile_region:"Nom de région" | Capte tous les tweets des comptes ayant été identifiés comme étant d'une certaine région grâce au champs "Localisation". | accident profile_region:"midi-pyrénées" Capte tous les tweets contenant le mot-clé "accident", écrits par des comptes identifiés comme en région Midi-Pyrénées, par exemple parce que le champs "Localisation" de leur biographie contient "Toulouse", ou "Lourdes". |
| profile_subregion:"Nom de département" | Capte tous les tweets des comptes ayant été identifiés comme étant dans un certain département (ou subdivision administrative équivalente pour les pays hors de France) grâce au champs "Localisation". | accident profile_subregion:"Département des Hauts-de-Seine" Capte tous les tweets contenant le mot-clé "accident", écrits par des comptes identifiés comme dans les Hauts-de-Seine, par exemple parce que leur champs "Localisation" contient "Antony" ou "92". |
| profile_locality:"Nom de ville" | Capte tous les tweets des comptes ayant été identifiés comme étant d'une certaine ville grâce au champs "Localisation". | accident profile_locality:Paris Capte tous les tweets contenant le mot-clé "accident", écrits par des comptes identifiés comme à Paris, par exemple parce que leur champs "Localisation" contient "Paris 2ième" ou "75002". |
| profile_point_radius:[LON LAT RAY] | Capte les tweets des comptes ayant été identifiés comme étant dans une zone circulaire donnée. LON = longitude en degrés (±180) LAT = latitude en degrés (±180) RAY = rayon du cercle, en précisant l'unité (entre 0 et 25mi ou entre à et 40km) | profile_point_radius:[2.3412 48.8569 50km] Capte tous les tweets des comptes ayant été identifiés comme dans une ville à moins de 50km de Paris. |
| profile_bounding_box:[LON1 LAT1 LON2 LAT2] | Capte les tweets des comptes ayant été identifiés comme dans une zone rectangulaire donnée. LON1 et LAT1 = longitude et latitude du coin sud-ouest de la zone rectangulaire LON2 et LAT2 = longitude et latitude du coin nord-est de la zone rectangulaire LON1, LAT1, LON2 et LAT2 en degrés (±180) | profile_bounding_box:[-105.301758 39.964069 -105.178505 40.09455] Capte tous les tweets des comptes ayant été identifiés comme dans une ville dans un rectangle autour de Boulder, Colorado, Etats-Unis. |
| statuses_count:AAA statuses_count:AAA..BBB | Capte tous les tweets des comptes ayant une certaine activité à leur actif. AAA = borne inférieure BBB = borne supérieure Opérateur non disponible pour la récupération rétroactive de données. | statuses_count:100 Capte tous les tweets de comptes ayant fait au moins 100 tweets (au total). statuses_count:100..10000 Capte tous les tweets de comptes ayant fait au moins 100 tweets (au total), mais moins de 10 000. |
| followers_count:AAA followers_count:AAA..BBB | Capte tous les tweets des comptes ayant un certain nombre d'abonnés. AAA = borne inférieure BBB = borne supérieure Opérateur non disponible pour la récupération rétroactive de données. | followers_count:10000 Capte tous les tweets de comptes ayant au moins 10 000 abonnés. followers_count:10000..1000000 Capte tous les tweets de comptes ayant au moins 10 000 abonnés, mais moins de 1 million. |
| friends_count:AAA friends_count:AAA..BBB | Capte tous les tweets des comptes ayant un certain nombre d'abonnements. AAA = borne inférieure BBB = borne supérieure Opérateur non disponible pour la récupération rétroactive de données. | friends_count:10 Capte tous les tweets de comptes ayant au moins 10 000 abonnements. friends_count:10..1000 Capte tous les tweets de comptes ayant au moins 10 abonnements, mais moins de 1000. |
| listed_count:AAA listed_count:AAA..BBB | Capte tous les tweets des comptes ayant été ajoutés dans un certain nombre de listes. AAA = borne inférieure BBB = borne supérieure Opérateur non disponible pour la récupération rétroactive de données. | listed_count:100 Capte tous les tweets de comptes ayant été ajoutés dans au moins 100 listes. friends_count:100..1000 Capte tous les tweets de comptes été ajoutés dans au moins 100 listes, mais moins de 1000. |
| is:verified | Capte tous les tweets de comptes vérifiés. | coca is:verified Capte tous les tweets contenant le mot-clé coca et écrits par des comptes vérifiés. |
Identifier des influenceurs grâce aux opérateurs sur les profils Twitter
Les opérateurs de profils Twitter servent initialement à filtrer des mots-clés. Ils peuvent également être détournés pour être utilisés sans mots-clés et détecter ainsi des influenceurs, comme un moteur de recherche de profils Twitter.
Comme la plupart des opérateurs de profils ne marchent pas rétroactivement, il faut créer un sujet et le laisser actif pendant quelques jours, et que les comptes aient tweeté au moins une fois pendant la période pour apparaître dans la plateforme Visibrain.
Vous pouvez par exemple utiliser la règle suivante :
(bio:journaliste OR bio:rédacteur) profile_region:"midi-pyrénées" followers_count:1000
pour capter tous les profils Twitter de journalistes, habitants en région Midi-Pyrénées, et ayant au moins 1000 followers.
Opérateurs sur la géolocalisation GPS Twitter
Les opérateurs sur la géolocalisation qui suivent ne concernent que les tweets ayant activé la géolocalisation GPS, c'est-à-dire <0,5% des tweets.
Sauf besoin spécifique, nous vous recommandons d'utiliser plutôt les opérateurs profile_country:, profile_region: et profile_locality: si vous vous intéressez à la localisation.
| Opérateur | Explication | Exemple |
|---|---|---|
| point_radius:[LON LAT RAY] | Capte les tweets géolocalisés dans une zone circulaire donnée. LON = longitude en degrés (±180) LAT = latitude en degrés (±180) RAY = rayon du cercle, en précisant l'unité (entre 0 et 25mi ou entre 0 et 40km) | point_radius:[2.3412 48.8569 5km] Capte tous les tweets géolocalisés entre 0 et 5km du centre de Paris. |
| bounding_box:[LON1 LAT1 LON2 LAT2] | Capte les tweets géolocalisés dans une zone rectangulaire donnée. LON1 et LAT1 = longitude et latitude du coin sud-ouest de la zone rectangulaire LON2 et LAT2 = longitude et latitude du coin nord-est de la zone rectangulaire LON1, LAT1, LON2 et LAT2 en degrés (±180) | bounding_box:[-105.301758 39.964069 -105.178505 40.09455] Capte tous les tweets géolocalisés dans un rectangle autour de Boulder, Colorado, Etats-Unis. |
| place:"Nom de lieu" | Capte les tweets géolocalisés sur un lieu spécifique. | place:"Paris" Capte les tweets géolocalisés dans Paris. |
| place_country:XX | Capte les tweets ayant été géolocalisés dans un certain pays. XX = abbréviation du pays Liste des pays disponibles L'opérateur place_country opère sur la géolocalisation GPS des tweets ayant activé la géolocalisation GPS, c'est à dire 0,5 % des tweets. Nous vous conseillons d'utiliser l'opérateur : profile_country:fr | place_country:fr Capte les tweets géolocalisés en France. |
| has:geo | Capte les tweets qui contiennent une information de géolocalisation, quelle qu'elle soit. | accident has:geo Capte tous les tweets géolocalisés qui contiennent le mot-clé "accident". |
Opérateurs avancés
Les opérateurs avancés qui suivent n'ont pas d'utilité pour la majorité des cas.
Nous vous recommandons de privilégier les opérateurs en haut de la page.
Si besoin, n'hésitez pas à contacter votre chargé(e) de compte pour qu'il/elle vous conseille sur les meilleures règles à utiliser par rapport à votre problématique.
| Opérateur | Explication | Exemple |
|---|---|---|
| "mot-clé1 mot-clé2"~N | Opérateur de proximité entre mots-clés. N = nombre de mots autorisés entre mot-clé1 et mot-clé2 (entre 1 et 6) | "voiture bleue"~2 Captera "ma voiture rouge et bleue" Mais ne captera pas "ma voiture rouge et ma camionnette bleue". |
| url_contains:élément | Capte tous les contenus web dont l'URL contient la partie de mot "élément". Opérateur non disponible pour la récupération rétroactive de données. | url_contains:times Capte tous les articles de thetimes.co.uk, nytimes.com... |
| is:retweet | Capte uniquement les retweets. | "signal faible" -is:retweet Capte tous les tweets originaux contenant l'expression "signal faible", mais ne capte pas les retweets associés. |
| is:quote | Capte uniquement les tweets citant un autre tweet. | "à dérouler" is:quote Capte tous les tweets contenant l'expression-clé "à dérouler", et qui pointent vers un autre tweet. |
| has:links | Capte uniquement les tweets contenant un lien. | "j'aime" -has:links Capte tous les tweets contenant l'expression clé "j'aime", mais qui ne contiennent pas de lien. |
| sample:ZZ | Permet de ne récupérer qu'un échantillon des données. ZZ = un pourcentage, entre 1 et 100 Opérateur non disponible pour la récupération rétroactive de données. | coca sample:10 Capte 10% du contenu contenant le mot-clé "coca". |
| $SYMBOLE | Capte toutes les publications contenant un cashtag spécifique. | $AMZN Capte toutes les publications contenant $AMZN, c'est-à-dire évoquant le cotation boursière de l'entreprise Amazon. |
| bio_location:mot-clé | Capte tous les tweets des comptes ayant "mot-clé" dans leur champs "Localisation". Privilégier plutôt les opérateurs profile_country:, profile_region: et profile_locality: qui infèrent directement le pays, région et ville à partir du champs "Localisation". Opérateur non disponible pour la récupération rétroactive de données. | bio_location:Eiffel Capte tous les tweets de personnes ayant mis le mot-clé "Eiffel" dans leur champs "Localisation". |
| has:profile_geo | Capte tous les tweets par des comptes dont Visibrain a réussi à identifier (à partir du champs de profil "Localisation") la localisation. | bonjour lang:fr has:profile_geo Capte les tweets francophones contenant le mot-clé "Bonjour", et émis par les comptes dans lesquels Visibrain a réussi à identifier la localisation. |
| time_zone:"Nom de timezone" | Capte les tweets des personnes ayant renseigné une timezone spécifique dans leur profil. Opérateur non disponible pour la récupération rétroactive de données. | time_zone:"Paris" Capte tous les tweets des profils ayant réglé explicitement leur profil sur la timezone Paris (GMT+1). |
| source:"Nom du client Twitter" | Capte les tweets émis à partir d'un client (logiciel) Twitter spécifique. Opérateur non disponible pour la récupération rétroactive de données. | source:tweetdeck Capte les tweets émis avec TweetDeck (c'est-à-dire très souvent les tweets d'utilisateurs aguerris). |
| has:mentions | Capte les tweets qui mentionnent un autre utilisateur. | bonjour -has:mentions Capte les tweets contenant le mot-clé "bonjour", mais qui ne mentionnent pas un autre utilisateur Twitter. |
| has:hashtags | Capte les tweets contenant au moins un hashtag. | coca has:hashtags Capte les tweets contenant le mot-clé "coca", et un hashtag quel qu'il soit (par exemple : "#Love Coca") |
| has:symbols | Capte les tweets contenant au moins un cashtag. | breaking has:symbols Capte les tweets contenant le mot-clé "breaking", et un cashtag quel qu'il soit (par exemple : "Breaking News, $AMZN stock up") |
| has:media has:images has:video | Capte les tweets qui contiennent un média attaché, ou plus spécifiquement une image ou une vidéo. | #NouvelAn has:media Capte les tweets avec le hashtag #nouvelan qui contiennent une image ou une vidéo. #NouvelAn has:video Capte les tweets avec le hashtag #nouvelan qui contiennent une vidéo (mais pas ceux qui contiennent une image). |
| retweets_of_status_id:ID | Capte tous les retweets d'un tweet spécifique. ID = l'id exact du tweet désiré Opérateur non disponible pour la récupération rétroactive de données. | retweets_of_status_id:821391052594614272 Capte tous les retweets de ce tweet. |
| in_reply_to_status_id:ID | Capte tous les tweets réponses à un tweet spécifique. ID = l'id exact du tweet désiré Opérateur non disponible pour la récupération rétroactive de données. | in_reply_to_status_id:821391052594614272 Capte toutes les réponses à ce tweet. |
Opérateurs non disponibles en récupération rétroactive
Certains opérateurs ne sont pas disponibles pour la récupération de données passées (mais ils fonctionnent parfaitement pour la récupération en temps-réel).
Vous pouvez créer votre Topic sans ces derniers dans un premier temps, puis les rajouter par la suite.
Si vous avez validé votre Topic sans récupérer de données passées, vous pouvez contacter votre chargé(e) de compte pour qu'il vous récupère les données passées a posteriori (sur les opérateurs qui le permettent).
Opérateurs usuels non disponibles en récupération rétroactive : contains:, url_title, url_description:, bio:, bio_name:, status_count:, followers_count:, friends_count:, listed_count:
Opérateurs avancés non disponibles en récupération rétroactive : url_contains:, sample:, bio_location:, time_zone:, source:, retweets_of_status_id:, in_reply_to_status_id
Updated almost 6 years ago
Consultez les pages suivantes pour avoir des exemples concrets de création de sujet selon votre besoin.