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érateurExplicationExemple
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.
#hashtagCapte 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 #.
emojiCapte toutes les publications contenant un emoji spécifique.😂
Capte l'ensemble des publications contenant l'emoji "joy".
contains:élémentCapte 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:XXPermet 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érateurExplicationExemple
from:utilisateurCapte toute l'activité du compte Twitter @utilisateurfrom: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:utilisateurCapte 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 @utilisateurto: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érateurExplicationExemple
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érateurExplicationExemple
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:XXCapte 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érateurExplicationExemple
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érateurExplicationExemple
"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émentCapte 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:ZZPermet 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".
$SYMBOLECapte 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_geoCapte 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:symbolsCapte 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


A lire aussi

Consultez les pages suivantes pour avoir des exemples concrets de création de sujet selon votre besoin.