| « correspondance exacte de la phrase » | PowerTrack
Search | Fait correspondre une phrase exacte dans le corps d’une Publication.
Les composants pouvant être interprétés comme des opérateurs de recherche seront traités comme des mots. En d’autres termes :
* "#hashtag" correspondra à hashtag mais pas à #hashtag (utilisez l’opérateur hashtag sans guillemets pour faire correspondre de vrais hashtags) * "$TWTR" correspondra au mot TWTR mais pas au cashtag $TWTR (utilisez l’opérateur cashtag sans guillemets pour faire correspondre de vrais cashtags)
Note : dans 30 Day Search et Full Archive Search (Enterprise et Premium), la ponctuation n’est pas tokenisée et est traitée comme un caractère d’espacement. | text |
| @ | PowerTrack
Search | Correspond à toute Publication mentionnant le nom d’utilisateur donné. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’ID numérique de l’utilisateur (obtenu par exemple via le point de terminaison GET users/lookup). | entities.user_mentions |
| # | PowerTrack
Search | Correspond à toute Publication contenant le hashtag indiqué.
Cet opérateur réalise une correspondance exacte. Par exemple, la règle #1989 correspondra aux Publications qui contiennent exactement le hashtag #1989, mais pas à celles avec le hashtag #TaylorSwift1989.
Remarque : cet opérateur repose sur l’extraction d’entités de X pour faire correspondre les hashtags, plutôt que sur l’extraction du hashtag directement à partir du corps de la Publication. Pour plus de détails sur les attributs JSON provenant des entités, consultez X Entities. | entities.hashtags |
| $ | PowerTrack
Search | Fait correspondre toute Publication contenant le cashtag spécifié (dont le premier caractère du jeton est $).
Remarque : cet opérateur s’appuie sur l’extraction des entités par X pour faire correspondre les liens, plutôt que d’extraire le lien à partir du corps du message lui‑même. Pour plus de détails sur les attributs JSON des entités, consultez X Entities. | entities.symbols |
| bio: | PowerTrack | Alias disponible : user_bio:
Fait correspondre un mot-clé (à l’aide d’une correspondance tokenisée) ou une expression dans la biographie utilisateur associée à une Publication. Utilisez des guillemets doubles pour faire correspondre une expression. En d’autres termes :
* bio:software engineer correspondra aux Publications contenant le mot-clé engineer provenant d’utilisateurs ayant le mot software dans leur bio * bio:"software engineer" correspondra à toute Publication émise par des utilisateurs ayant l’expression software engineer dans leur bio | user``.description |
| bio_location: | PowerTrack | Alias disponible : user_bio_location:
Fait correspondre les Publications pour lesquelles l’emplacement de l’objet User contient le mot-clé spécifié (avec une correspondance tokenisée) ou l’expression indiquée.
Cet emplacement est une chaîne de caractères libre, non normalisée, générée par l’utilisateur, et il est différent de l’emplacement d’une Publication (lorsque celui-ci est disponible). | user.location |
| bio_name: | PowerTrack | Renvoie les Publications dont le nom de l’objet User contient le mot-clé spécifié (en utilisant une correspondance tokenisée) ou l’expression. | user.name |
| bounding_box: | PowerTrack
Search | Alias disponible : geo_bounding_box:
Effectue une correspondance avec l’emplacement exact (long, lat) de la Publication (lorsqu’il est présent) et avec un polygone géographique (lorsque l’objet Place est entièrement contenu dans la région définie).
* west_long et south_lat représentent le coin sud-ouest du rectangle englobant, où west_long est la longitude de ce point et south_lat est la latitude. * east_long et north_lat représentent le coin nord-est du rectangle englobant, où east_long est la longitude de ce point et north_lat est la latitude. * La largeur et la hauteur du rectangle englobant doivent être inférieures à 25 mi * La longitude est dans l’intervalle ±180 * La latitude est dans l’intervalle ±90 * Toutes les coordonnées sont en degrés décimaux. * Les arguments de règle sont placés entre crochets et séparés par des espaces.
Remarque : les opérateurs faisant correspondre place (géo de la Publication) n’incluront que des correspondances provenant des Publications originales. Les Retweets ne contiennent aucune donnée de lieu. | place (Publications originales uniquement) |
| contains: | PowerTrack | Correspondance de sous-chaîne pour les Publications dont le contenu contient la sous-chaîne donnée, indépendamment de la tokenisation. En d’autres termes, il s’agit d’une correspondance de sous-chaîne pure qui ne tient pas compte des limites de mots.
Utilisez des guillemets doubles pour faire correspondre des sous-chaînes qui contiennent des espaces ou des signes de ponctuation. | text |
| <emoji> | PowerTrack
Search | Correspond à un emoji présent dans le corps d’une Publication.
Il s’agit d’une correspondance basée sur la tokenisation : votre emoji est donc comparé au texte tokenisé du corps de la Publication. La tokenisation est basée sur la ponctuation, les symboles/emoji et les caractères séparateurs du plan multilingue de base Unicode. Par exemple, une Publication contenant le texte « I like 🍕 » serait découpée en les jetons suivants : I, like, 🍕. Ces jetons seraient ensuite comparés à l’emoji utilisé dans votre règle.
Remarque : si un emoji possède une variante, vous devez utiliser des guillemets doubles pour l’ajouter à une règle. | text |
| followers_count: | PowerTrack | Renvoie les Publications lorsque l’auteur a un nombre d’abonnés situé dans l’intervalle indiqué.
* Un nombre unique (par ex. followers_count:42) correspond à toute valeur supérieure ou égale à la valeur spécifiée. * Un intervalle (par ex. followers_count:42..1337) correspond à toute valeur comprise dans l’intervalle indiqué. | user.followers_count |
| friends_count: | PowerTrack | Alias disponible : following_count:
Correspond aux Publications lorsque l’auteur a un nombre d’abonnements (le nombre d’utilisateurs qu’il suit) situé dans l’intervalle donné.
* Un nombre unique (par ex. followers_count:42) correspondra à tout nombre supérieur ou égal à la valeur indiquée. * Un intervalle (par ex. followers_count:42..1337) correspondra à tout nombre dans l’intervalle donné. | user.friends_count |
| from: | PowerTrack
Search | Fait correspondre toute Publication provenant d’un utilisateur spécifique. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’ID numérique de l’utilisateur (obtenu par exemple via le point de terminaison GET users/lookup). | user.id, user.id_str (si vous utilisez l’identifiant utilisateur)
user.screen_name (si vous utilisez le nom d’utilisateur) |
| has:geo | PowerTrack
Search | Fait correspondre les Publications qui disposent de données de géolocalisation spécifiques à la Publication, fournies par X. Il peut s’agir soit de coordonnées « geo » (latitude‑longitude), soit d’un « location » sous la forme d’un objet X Place, avec le nom d’affichage correspondant, le polygone géographique et d’autres champs.
Ne peut pas être utilisé comme opérateur autonome.
Remarque : les opérateurs qui font correspondre place (géolocalisation de la Publication) n’incluront que des correspondances issues des Publications originales. Les Retweets ne contiennent aucune donnée de lieu. | place (Tweets originaux uniquement) |
| has:hashtags | PowerTrack
Search | Correspond aux Publications qui contiennent au moins un hashtag.
Ne peut pas être utilisé comme opérateur autonome. | entities.hashtags |
| has:images | PowerTrack
Search | Identifie les Publications qui contiennent au moins une URL d’image classifiée.
Ne peut pas être utilisé en tant qu’opérateur autonome. | entities.media |
| has:lang | PowerTrack | Renvoie les Publications qui ont été classées par X comme étant rédigées dans une langue donnée.
Si une Publication n’a pas été classée, l’opérateur ne renverra aucun résultat. Chaque Publication est actuellement classée dans une seule langue ; par conséquent, combiner plusieurs langues avec AND ne renverra aucun résultat.
Ne peut pas être utilisé comme opérateur autonome. | lang lorsque la valeur n’est pas und |
| has:links | PowerTrack
Search | Cet opérateur renvoie les Publications qui contiennent des liens dans le corps de la Publication.
Ne peut pas être utilisé seul en tant qu’opérateur.
Remarque : cet opérateur s’appuie sur l’extraction d’entités par X pour faire correspondre les liens, plutôt que d’extraire le lien directement à partir du corps lui‑même. Pour plus de détails sur les attributs JSON des entités, consultez X Entities. | entities.urls |
| has:media | PowerTrack
Search | Alias disponible : has:media_link
Correspond aux Publications contenant au moins une URL de média classifiée.
Ne peut pas être utilisé comme opérateur autonome. | entities.media |
| has:mentions | PowerTrack
Search | Renvoie les Publications qui mentionnent un autre utilisateur de X.
Ne peut pas être utilisé comme opérateur indépendant. | entities.user_mentions |
| has:profile_geo | PowerTrack
Search | Alias disponible : has:derived_user_geo
Identifie les Publications qui comportent des métadonnées Profile Geo, quelle que soit leur valeur réelle.
Ne peut pas être utilisé comme opérateur autonome. | user.location |
| has:symbols | PowerTrack
Enterprise | Fait correspondre les Publications contenant un cashtag (par exemple $TWTR).
Ne peut pas être utilisé seul en tant qu’opérateur. | entities.symbols |
| has:videos | PowerTrack
Search | Alias disponible : has:video_link
Renvoie les Publications qui contiennent au moins une URL de média classifié.
Ne peut pas être utilisé comme opérateur autonome. | entities.media |
| in_reply_to_status_id: | PowerTrack | Alias disponible: in_reply_to_tweet_id:
Ne renvoie que les réponses explicites à la Publication spécifiée. | id, id_str de la Publication cible |
| is:quote | PowerTrack | Délivre des Tweets cités explicites qui correspondent à une règle.
Il peut également être utilisé avec la négation (-is:quote) pour exclure de la livraison les Tweets cités qui correspondent à une règle.
Ne peut pas être utilisé comme opérateur autonome. | is_quote_status (si égal à true) |
| is:reply | PowerTrack
Search | Livrer uniquement les réponses qui correspondent à une règle.
Vous pouvez également le précéder d’un signe moins (-is:reply) afin d’exclure la livraison des réponses qui correspondent à la règle spécifiée.
Avec PowerTrack, cet opérateur s’applique aux :
* Réponses à une Publication originale * Réponses dans des Publications citées * Réponses dans des Retweets
Lorsqu’il est utilisé avec l’API Search, cet opérateur correspond aux réponses à une Publication originale, mais exclut les réponses dans les Tweets cités et les réponses dans les Retweets.
Vous pouvez utiliser cet opérateur conjointement avec is:retweet et is:quote pour ne livrer que les réponses aux Publications originales.
Ne peut pas être utilisé comme opérateur autonome avec l’API Search.
Remarque : avec Premium, cet opérateur n’est pas disponible dans les environnements de développement Sandbox. | Éléments de réponse, par exemple in_reply_to_status_id |
| is:retweet | PowerTrack
Search | Ne livrer que les Retweets explicites qui correspondent à une règle.
Il peut également être utilisé sous forme négative (-is:retweet) pour exclure de la livraison les Retweets qui correspondent à une règle et ne livrer que le contenu original.
Cet opérateur recherche uniquement les vrais Retweets (c.-à-d. les Retweets publiés à l’aide du bouton Retweet). Les Tweets cités et les Publications modifiées qui n’utilisent pas la fonctionnalité de Retweet de X ne seront pas pris en compte par cet opérateur.
Ne peut pas être utilisé comme opérateur autonome. | Éléments de Retweet, par exemple retweeted_status |
| is:verified | PowerTrack
Search | Ne renvoie que les Publications dont l’auteur est vérifié par X.
Peut également être utilisé sous forme négative pour exclure les Publications dont l’auteur est vérifié.
Ne peut pas être utilisé comme opérateur autonome. | user.verified |
| keyword | PowerTrack
Search | Fait correspondre un mot-clé dans le corps d’une Publication.
Il s’agit d’une correspondance basée sur la tokenisation, ce qui signifie que votre chaîne de mots-clés sera comparée au texte tokenisé du corps de la Publication. La tokenisation est basée sur les caractères de ponctuation, de symboles/emoji et de séparation du plan de base Unicode. Par exemple, une Publication avec le texte « I like coca-cola » serait découpée en tokens comme suit : I, like, coca, cola. Ces tokens sont ensuite comparés à la chaîne de mots-clés utilisée dans votre règle. Pour faire correspondre des chaînes contenant des signes de ponctuation (par exemple coca-cola), des symboles ou des caractères de séparation, vous devez utiliser l’opérateur de correspondance de phrase exacte. | text |
| lang: | PowerTrack
Search | Correspond aux Publications qui ont été classées par X comme étant d’une langue particulière (si, et seulement si, la Publication a été classée). Chaque Publication sera classée dans une seule langue, donc combiner plusieurs langues avec l’opérateur AND ne renverra aucun résultat.
Remarque : si aucune classification de langue ne peut être effectuée, la valeur attribuée est und (pour indéfinie).
Cet opérateur ne prendra en compte que les langues prises en charge. Toute autre valeur fournie (y compris und) aura pour effet d’ignorer l’opérateur (en d’autres termes, les Publications ne seront pas filtrées par cet opérateur). La liste ci‑dessous représente les langues actuellement prises en charge et leur identifiant de langue BCP 47 correspondant :
am amharique
hu hongrois
pt portugais
ar arabe
is islandais
ro roumain
hy arménien
in indonésien
ru russe
bn bengali
it italien
sr serbe
bg bulgare
ja japonais
sd sindhi
my birman
kn kannada
si singhalais
zh chinois
km khmer
sk slovaque
cs tchèque
ko coréen
sl slovène
da danois
lo lao
ckb kurde sorani
nl néerlandais
lv letton
es espagnol
en anglais
lt lituanien
sv suédois
et estonien
ml malayalam
tl tagalog
fi finnois
dv maldivien
ta tamoul
fr français
mr marathi
te télougou
ka géorgien
ne népalais
th thaï
de allemand
no norvégien
bo tibétain
el grec
or oriya
tr turc
gu goujarati
pa pendjabi
uk ukrainien
ht haïtien
ps pachto
ur ourdou
iw hébreu
fa persan
ug ouïghour
hi hindi
pl polonais
vi vietnamien
cy gallois | lang lorsque la valeur n’est pas und |
| listed_count: | PowerTrack | Alias disponible : user_in_lists_count:
Fait correspondre les Publications dont le nombre de fois où l’auteur a été ajouté à des Listes sur X se situe dans l’intervalle indiqué.
* Un seul nombre (par ex. listed_count:42) correspondra à toute valeur supérieure ou égale à la valeur spécifiée. * Un intervalle (par ex. listed_count:42..1337) correspondra à toute valeur comprise dans l’intervalle indiqué. | user.listed_count |
| place_country: | PowerTrack
Search | Fait correspondre les Publications dont le code pays associé à un lieu/emplacement correspond au code ISO alpha-2 à deux lettres fourni.
Remarque : les opérateurs faisant correspondre place (géolocalisation de la Publication) n’incluront que les résultats provenant de Publications originales. Les Retweets ne contiennent aucune donnée de lieu. | place (Publications originales uniquement) |
| place: | PowerTrack
Search | Correspond à des Publications associées au lieu spécifié ou à un X place ID. Les noms de lieu composés de plusieurs mots doivent être entourés de guillemets (par exemple : place:"San Francisco")
Remarque : les opérateurs qui font correspondre le champ place (géo de la Publication) ne renverront que des correspondances issues de Publications originales. Les Retweets ne contiennent aucune donnée de lieu. | place (Publications originales uniquement) |
| point_radius: | PowerTrack
Search | Remarque : les opérateurs qui effectuent un filtrage sur place (géolocalisation de la Publication) ne renverront que des correspondances issues de publications originales. Les Retweets ne contiennent aucune donnée de lieu. | place (seulement les publications originales) |
| profile_bounding_box:[west_long south_lat east_long north_lat] | PowerTrack | Correspond à la localisation exacte de l’utilisateur (long, lat) dans l’enrichissement Profile Geo, où la Place est entièrement contenue dans la région définie.
* west_long et south_lat représentent le coin sud-ouest de la boîte englobante, où west-long est la longitude de ce point et south_lat en est la latitude. * east_long et north_lat représentent le coin nord-est de la boîte englobante, où east_long est la longitude de ce point et north_lat en est la latitude. * La largeur et la hauteur de la boîte englobante doivent être inférieures à 25 mi * La longitude est dans l’intervalle ±180 * La latitude est dans l’intervalle ±90 * Toutes les coordonnées sont en degrés décimaux. * Les arguments de règle sont placés entre crochets et séparés par des espaces.
Note : les opérateurs correspondant au champ place (geo de la Publication) n’incluent que les correspondances provenant des Publications originales. Les Retweets ne contiennent aucune donnée de lieu. | user.derived.locations.geo.coordinates |
| profile_country: | PowerTrack
Search | Correspondance exacte sur le code de pays issu de l’enrichissement Profile Geo.
Utilise un ensemble normalisé de codes de pays à deux lettres, fondé sur la spécification ISO-3166-1-alpha-2.
Par souci de concision, cet opérateur est fourni à la place d’un opérateur pour le champ country de l’objet address.
Remarque : les opérateurs faisant correspondre place (Post geo) n’incluront que des correspondances provenant de publications originales. Les Retweets ne contiennent aucune donnée de lieu. | user.derived.locations.country_code |
| profile_locality: | PowerTrack
Search | Correspondance exacte sur le champ « Locality » de l’enrichissement Profile Geo.
Il s’agit d’une correspondance exacte sur la chaîne entière.
Il n’est pas nécessaire d’échapper les caractères avec une barre oblique inverse. Par exemple, pour faire correspondre une valeur contenant une barre oblique, utilisez one/two.
Utilisez des guillemets doubles pour faire correspondre des sous-chaînes contenant des espaces ou de la ponctuation, par exemple profile_locality:"Lower East Side". | user.derived.locations.locality |
| profile_point_radius:[lon lat radius] | PowerTrack | Effectue une correspondance avec l’emplacement exact (x,y) de l’enrichissement Profile Geo de l’utilisateur.
* Les unités de rayon prises en charge sont les miles (mi) et les kilomètres (km). * Le rayon doit être inférieur à 25 mi. * La longitude est comprise entre -180 et +180 * La latitude est comprise entre -90 et +90 * Toutes les coordonnées sont en degrés décimaux. * Les arguments de règle sont placés entre crochets et délimités par des espaces.
Remarque : les opérateurs correspondant au champ place (géolocalisation de la Publication) n’incluront que les correspondances issues de publications originales. Les Retweets ne contiennent aucune donnée de lieu. | user.derived.locations.geo |
| profile_region: | PowerTrack
Search | Correspondance exacte avec le champ Region de l’enrichissement Profile Geo.
Il s’agit d’une correspondance exacte sur la chaîne complète.
Il n’est pas nécessaire d’échapper les caractères avec une barre oblique inversée. Par exemple, si vous faites correspondre une valeur contenant une barre oblique, utilisez one/two.
Utilisez des guillemets doubles pour faire correspondre des sous-chaînes qui contiennent des espaces ou des signes de ponctuation, par exemple profile_locality:"New York". | user.derived.locations.region |
| profile_subregion: | PowerTrack | Correspondance exacte sur le champ Subregion de l’enrichissement Profile Geo.
Il s’agit d’une correspondance exacte sur la chaîne de caractères complète.
Il n’est pas nécessaire d’échapper les caractères avec une barre oblique inverse. Par exemple, pour faire correspondre quelque chose contenant une barre oblique, utilisez one/two.
Utilisez des guillemets doubles pour faire correspondre des sous-chaînes qui contiennent des espaces ou de la ponctuation, par exemple profile_locality:"Kings County". | user.derived.locations.sub_region |
| ”keyword1 keyword2”~N | PowerTrack
Search | Généralement appelé opérateur de proximité, celui-ci fait correspondre une Publication dans laquelle les mots‑clés sont séparés par au plus N jetons.
Si les mots‑clés apparaissent dans l’ordre inverse, ils ne peuvent pas être séparés par plus de N‑2 jetons.
Peut inclure n’importe quel nombre de mots‑clés entre guillemets.
N ne peut pas être supérieur à 6. | text |
| retweets_of_status_id: | PowerTrack | Alias disponible : retweets_of_tweet_id:
Renvoie uniquement les Retweets explicites de la Publication originale spécifiée. | retweeted_status.id, retweeted_status.id_str |
| retweets_of: | PowerTrack
Search | Alias disponible : retweets_of_user:
Correspond à toute Publication qui est un Retweet de l’utilisateur indiqué. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’identifiant numérique de l’utilisateur (obtenu par exemple via l’endpoint GET users/lookup). | retweeted_status.id (le cas échéant) |
| sample: | PowerTrack | Renvoie un échantillon aléatoire, en pourcentage, de Publications qui correspondent à une règle plutôt que l’ensemble des Publications. La valeur en pourcentage doit être représentée par un entier compris entre 1 et 100.
Cet opérateur s’applique à l’ensemble de la règle et nécessite que tous les termes reliés par OR soient regroupés.
Remarque : l’opérateur sample réduit d’abord la portée du firehose à X %, puis la règle ou le filtre est appliqué à ce sous-ensemble échantillonné. Si vous utilisez, par exemple, sample:10, chaque Publication a 10 % de chances de faire partie de l’échantillon.
Remarque : l’échantillonnage est déterministe, et vous obtiendrez le même échantillon de données en temps réel que si vous récupériez les données a posteriori. | |
| source: | PowerTrack | Correspond à toute Publication générée par l’App source fournie. La valeur doit être le nom de l’App ou l’URL de l’App.
Ne peut pas être utilisé comme opérateur autonome. | source |
| statuses_count: | PowerTrack | Alias disponible : tweets_count:
Correspond aux Publications lorsque l’auteur a publié un nombre de statuts qui se situe dans l’intervalle indiqué.
* Un seul nombre (par ex. statuses_count:42) correspondra à tout nombre supérieur ou égal à la valeur indiquée. * Un intervalle (par ex. statuses_count:42..1337) correspondra à tout nombre compris dans l’intervalle indiqué. | user``.statuses_count |
| to: | PowerTrack
Search | Correspond à toute Publication qui est une réponse à un utilisateur donné. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’identifiant numérique de l’utilisateur (obtenu par exemple via le point de terminaison GET users/lookup). | text |
| url: | PowerTrack
Search | Effectue une correspondance tokenisée sur les URL développées d’une Publication. Les jetons et les expressions contenant de la ponctuation ou des caractères spéciaux doivent être placés entre guillemets doubles (par exemple url:"/developer").
Bien que généralement déconseillé, l’opérateur peut également effectuer une correspondance sur un protocole spécifique, lui aussi placé entre guillemets doubles (par exemple url:"https://developer.x.com"). | entities.urls.expanded_url |
| url_contains: | PowerTrack | Effectue une recherche par mot-clé ou expression sur le nouvel enrichissement de métadonnées de titre de l’URL étendue. | entities.urls.expanded_url |
| url_description: | PowerTrack | Alias disponible : within_url_description:
Effectue une recherche par mot-clé/phrase sur le (nouvel) enrichissement des métadonnées de description de page étendue. | entities.urls.unwound.description |
| url_title: | PowerTrack | Alias disponible : within_url_title :
Effectue une recherche par mot-clé ou expression sur le nouvel enrichissement de métadonnées du titre d’URL développé. | entities.urls.title |