Opérateurs de recherche

Cette page fournit une liste des opérateurs disponibles lors de la création d’une requête pour les points de terminaison de l’API Search v2.

​

Liste des opérateurs

Remarque : pour certains opérateurs, un nom alternatif (alias) est disponible.

Opérateur	Type	Description
keyword	Autonome	Fait correspondre un mot-clé présent dans le corps d’une Publication. Il s’agit d’une correspondance tokenisée, ce qui signifie que votre chaîne de mots-clés sera comparée au texte tokenisé du corps de la Publication. La tokenisation sépare les mots en fonction de la ponctuation, des symboles et des caractères séparateurs du plan multilingue de base Unicode. Par exemple, une Publication contenant le texte « I like coca-cola » serait divisée en jetons suivants : I, like, coca, cola. Ces jetons seraient ensuite comparés à la chaîne de mots-clés utilisée dans votre requête. Pour faire correspondre des chaînes contenant de la ponctuation (par exemple coca-cola), des symboles ou des caractères séparateurs, vous devez entourer votre mot-clé de guillemets doubles. Exemple : pepsi OR cola OR "coca cola"
emoji	Autonome	Identifie un emoji présent dans le corps d’une Publication. Comme pour un mot-clé, la correspondance des emoji est effectuée après tokenisation, ce qui signifie que votre emoji sera comparé au texte tokenisé du corps de la Publication. Remarque : si un emoji possède une variante, vous devez l’entourer de guillemets doubles pour l’ajouter à une requête. Exemple : (😃 OR 😡) 😬
"correspondance exacte de l'expression"	Autonome	Fait correspondre l’expression exacte dans le corps d’une Publication. Exemple : ("X API" OR #v2) -"recent search"
#	Autonome	Correspond à toute Publication contenant un hashtag reconnu, si le hashtag est une entité reconnue dans une Publication. Cet opérateur effectue une correspondance exacte, et NON une correspondance tokenisée, ce qui signifie que la règle #thanku fera correspondre les publications contenant exactement le hashtag #thanku, mais pas celles avec le hashtag #thankunext. Exemple : #thankunext #fanart OR @arianagrande
@	Autonome	Fait correspondre toute Publication qui mentionne le nom d’utilisateur spécifié, si ce nom d’utilisateur est une entité reconnue (y compris le caractère @). Exemple : (@XDevelopers OR @API) -@X
$	Autonome	Correspond à toute Publication qui contient le « cashtag » spécifié (c’est‑à‑dire un jeton dont le premier caractère est le symbole $).<br /><br />Notez que l’opérateur de cashtag s’appuie sur l’extraction d’entités « symbols » de X pour identifier les cashtags, plutôt que d’essayer d’extraire le cashtag à partir du contenu de la Publication elle‑même.<br /><br />Exemple : `$twtr OR @XDevelopers -$fb`
from:	Autonome	Correspond à toute Publication provenant d’un utilisateur spécifique. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’identifiant numérique de l’utilisateur. Vous ne pouvez transmettre qu’un seul nom d’utilisateur ou ID par opérateur from:. Exemple : from:XDevelopers OR from:API -from:X
to:	Autonome	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. Vous ne pouvez indiquer qu’un seul nom d’utilisateur ou un seul id par opérateur to:. Exemple : to:XDevelopers OR to:API -to:X
url:	Autonome	Effectue une correspondance tokenisée sur toute URL correctement formatée présente dans une Publication. Cet opérateur effectue une correspondance sur le contenu des champs url ou expanded_url. Par exemple, une Publication contenant “You should check out X Developer Labs: https://t.co/c0A36SWil4” (avec l’URL courte redirigeant vers https://developer.twitter.com) correspondra aux deux règles suivantes : from:XDevelopers url:"https://developer.twitter.com" (car elle correspondra au contenu de entities.urls.expanded_url) from:XDevelopers url:"https://t.co" (car elle correspondra au contenu de entities.urls.url) Les jetons et expressions contenant de la ponctuation ou des caractères spéciaux doivent être placés entre guillemets doubles (par exemple, url:"/developer"). De même, pour faire correspondre un protocole spécifique, placez-le entre guillemets doubles (par exemple, url:"https://developer.twitter.com").
retweets_of:	Autonome	Renvoie les Publications qui sont des Retweets de l’utilisateur spécifié. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’id numérique de l’utilisateur. Vous ne pouvez indiquer qu’un seul nom d’utilisateur ou id par opérateur retweets_of:. Exemple : retweets_of:twitterdev OR retweets_of:twitterapi
in_reply_to_tweet_id:	Autonome	Alias disponible : in_reply_to_status_id: Correspond aux réponses à la Publication spécifiée. Exemple : in_reply_to_tweet_id:1539382664746020864
retweets_of_tweet_id:	Autonome	Alias disponible : retweets_of_status_id: Correspond aux Retweets explicites (ou natifs) de la Publication spécifiée. Notez que l’ID de la Publication utilisé doit être celui d’une Publication originale et non d’un Retweet. Exemple : retweets_of_tweet_id:1539382664746020864
quotes_of_tweet_id:	Autonome	Alias disponible : quotes_of_status_id: Fait correspondre les Tweets cités de la Publication spécifiée. Remarque : l’id de Publication utilisé doit être celui d’une Publication originale et non d’un Tweet cité. Exemple : quotes_of_tweet_id:1539382664746020864
context:	Autonome	Renvoie les Publications avec une paire spécifique id de domaine/id d’entité. Pour en savoir plus sur cet opérateur, veuillez consulter notre page sur les annotations. Vous ne pouvez spécifier qu’un seul domaine/entité par opérateur context:. context:domain_id.entity_id Cependant, vous pouvez combiner plusieurs domaines/entités en utilisant l’opérateur OR : (context:47.1139229372198469633 OR context:11.1088514520308342784) Exemples : context:10.799022225751871488 (domain_id.entity_id renvoie les Publications correspondant à cette paire domaine-entité spécifique)
entity:	Autonome	Renvoie les Publications correspondant à une valeur de chaîne de caractères d’entité spécifique. Pour en savoir plus sur cet opérateur, veuillez consulter notre page sur les annotations. Veuillez noter que cela n’est disponible qu’avec la recherche récente. Vous ne pouvez utiliser qu’un seul opérateur entity:. entity:"string declaration of entity/place" Exemples : entity:"Michael Jordan" OR entity:"Barcelona"
conversation_id:	Autonome	Fait correspondre les Publications qui partagent le même identifiant de conversation. Un identifiant de conversation correspond à l’ID de Publication de la Publication qui a lancé la conversation. Lorsqu’une Publication reçoit des réponses, y compris des réponses à ces réponses, le conversation_id est ajouté à sa charge utile JSON. Vous ne pouvez fournir qu’un seul identifiant de conversation par opérateur conversation_id:. Exemple : conversation_id:1334987486343299072 (from:XDevelopers OR from:api)
list:	Autonome	Renvoie les Publications publiées par des utilisateurs membres d’une Liste spécifiée. Par exemple, si @XDevelopers et @api étaient membres de la Liste 123 et que vous incluiez list:123 dans votre requête, votre réponse ne contiendrait que les Publications qui ont été publiées par ces comptes. Vous pouvez trouver les ID de Liste en utilisant le point de terminaison List lookup. Veuillez noter que vous ne pouvez utiliser qu’un seul opérateur list: par requête, et que vous ne pouvez spécifier qu’une seule Liste par opérateur list:. Exemple : list:123
place:	Autonome	Correspond aux Publications associées à l’emplacement spécifié ou à l’ID de lieu X. Les noms de lieux comportant plusieurs mots (« New York City », « Palo Alto ») doivent être entourés de guillemets. Vous ne pouvez spécifier qu’un seul lieu par opérateur place:. Remarque : consultez le point de terminaison standard v1.1 GET geo/search pour savoir comment obtenir des ID de lieu X. Remarque : cet opérateur n’inclura pas les Retweets, car les lieux d’un Retweet sont associés à la Publication originale. Il n’inclura pas non plus les lieux associés à la Publication originale d’un Quote Tweet. Exemple : place:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:	Autonome	Fait correspondre les Publications pour lesquelles le code pays associé à un lieu/emplacement tagué correspond au code ISO alpha-2 à deux caractères fourni. Vous pouvez trouver une liste des codes ISO valides sur Wikipedia. Vous ne pouvez transmettre qu’un seul code ISO par opérateur place_country:. Remarque : Cet opérateur ne fera pas correspondre les Retweets, car les lieux des Retweets sont associés à la Publication d’origine. Il ne fera pas non plus correspondre les lieux associés à la Publication d’origine d’un Quote Tweet. Exemple : place_country:US OR place_country:MX OR place_country:CA
point_radius:	Autonome	Correspond à l’objet place.geo.coordinates de la Publication lorsqu’il est présent et, dans X, à un polygone géographique de lieu, lorsque le polygone de lieu est entièrement contenu dans la région définie. point_radius:[longitude latitude radius] - 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 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 contenus entre crochets et séparés par des espaces Vous ne pouvez passer qu’un seul polygone géographique par opérateur point_radius:. Remarque : cet opérateur ne correspondra pas aux Retweets, car les lieux du Retweet sont rattachés à la Publication d’origine. Il ne correspondra pas non plus aux lieux rattachés à la Publication d’origine d’un Quote Tweet. Exemple : point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]
bounding_box:	Autonome	Alias disponible : geo_bounding_box: Correspond à l’objet place.geo.coordinates de la Publication lorsqu’il est présent et, dans X, à un polygone géographique de lieu, lorsque le polygone de lieu est entièrement contenu dans la région définie. bounding_box:[west_long south_lat east_long north_lat] - west_long 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 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 comprise dans l’intervalle ±180 - La latitude est comprise dans l’intervalle ±90 - Toutes les coordonnées sont en degrés décimaux. - Les arguments de règle sont contenus entre crochets, séparés par des espaces. Vous ne pouvez transmettre qu’un seul polygone géographique par opérateur bounding_box:. Remarque : cet opérateur ne fera pas correspondre les Retweets, car les lieux des Retweets sont rattachés à la Publication d’origine. Il ne fera pas non plus correspondre les lieux rattachés à la Publication d’origine d’un Quote Tweet. Exemple : bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweet	Conjonction nécessaire	Renvoie les Retweets qui correspondent au reste de la règle spécifiée. Cet opérateur recherche uniquement de véritables Retweets (par exemple, ceux générés via le bouton Retweet). Les Quote Tweets ne seront pas renvoyés par cet opérateur. Exemple : data @XDevelopers -is:retweet
is:reply	Conjonction nécessaire	Ne livrer que les réponses explicites qui correspondent à une règle. Peut également être utilisé avec une négation afin d’exclure de la diffusion les réponses qui correspondent à une requête. Remarque : cet opérateur est également disponible avec le point de terminaison filtered stream. Lorsqu’il est utilisé avec filtered stream, cet opérateur renvoie les réponses à une Publication originale, les réponses dans des Tweets cités et les réponses dans des Retweets. Exemple : from:XDevelopers is:reply
is:quote	Conjonction nécessaire	Renvoie tous les Tweets cités, également appelés Publications accompagnées d’un commentaire. Exemple : "sentiment analysis" is:quote
is:verified	Conjonction nécessaire	Renvoie uniquement les Publications dont les auteurs sont vérifiés par X. Exemple : #nowplaying is:verified
-is:nullcast	Conjonction nécessaire	Supprime les Publications créées uniquement à des fins promotionnelles sur ads.twitter.com qui ont "source":"Twitter for Advertisers (legacy)" ou "source":"Twitter for Advertisers". Cet opérateur doit être utilisé avec une négation. Pour plus d’informations sur les Publications nullcast, consultez notre page sur la disponibilité des Publications. Exemple : "mobile games" -is:nullcast
has:hashtags	Conjonction nécessaire	Renvoie les Publications qui contiennent au moins un hashtag. Exemple : from:XDevelopers -has:hashtags
has:cashtags	Conjonction nécessaire	Correspond aux Publications qui contiennent un symbole de cashtag (précédé du caractère « $». Par exemple «$tag »). Exemple : #stonks has:cashtags
has:links	Conjonction nécessaire	Cet opérateur correspond aux Publications qui contiennent des liens et des médias dans le corps de la Publication. Exemple : from:XDevelopers announcement has:links
has:mentions	Conjonction nécessaire	Renvoie les Publications qui mentionnent un autre utilisateur X. Exemple : #nowplaying has:mentions
has:media	Conjonction nécessaire	Alias disponible : has:media_link Permet de trouver les Publications qui contiennent un objet média, comme une photo, un GIF ou une vidéo, tel que déterminé par X. Cela n’inclut pas les médias créés avec Periscope, ni les Publications contenant des liens vers d’autres sites d’hébergement de médias. Exemple : (kittens OR puppies) has:media
has:images	Conjonction nécessaire	Correspond aux Publications qui contiennent une URL reconnue vers une image. Exemple : #meme has:images
has:video_link	Conjonction nécessaire	Alias disponible : has:videos Correspond aux Publications qui contiennent des vidéos X natives, envoyées directement sur X. Cela n’inclut pas les vidéos créées avec Periscope ni les Publications contenant des liens vers d’autres sites d’hébergement de vidéos. Exemple : #icebucketchallenge has:video_link
has:geo	Conjonction nécessaire	Fait correspondre les Publications qui disposent de données de géolocalisation propres à la Publication, fournies par l’utilisateur X. Il peut s’agir soit d’un emplacement sous la forme d’un lieu X, avec le nom d’affichage associé, un polygone géographique et d’autres champs, soit, dans de rares cas, de coordonnées géographiques latitude-longitude. Remarque : les opérateurs faisant correspondre un lieu (géolocalisation de la Publication) n’incluront que les correspondances provenant des Publications originales. Les Retweets ne contiennent aucune donnée de lieu. Exemple : recommend #paris has:geo -bakery
lang:	Conjonction nécessaire	Correspond aux Publications qui ont été classées par X comme étant dans une langue particulière (si, et seulement si, la Publication a été classée). Il est important de noter que chaque Publication n’est actuellement classée que dans une seule langue, donc utiliser un ET logique entre plusieurs langues ne renverra aucun résultat. Vous ne pouvez fournir qu’un seul identifiant de langue BCP 47 par opérateur lang:. Remarque : si aucune classification de langue ne peut être effectuée, le résultat retourné est « und » (pour non défini). Exemple : recommend #paris lang:en La liste ci-dessous représente les langues actuellement prises en charge et leur identifiant de langue BCP 47 correspondant : Amharique : am	Allemand : de	Malayalam : ml	Slovaque : sk Arabe : ar	Grec : el	Maldivien : dv	Slovène : sl Arménien : hy	Gujarati : gu	Marathi : mr	Kurde sorani : ckb Basque : eu	Créole haïtien : ht	Népali : ne	Espagnol : es Bengali : bn	Hébreu : iw	Norvégien : no	Suédois : sv Bosniaque : bs	Hindi : hi	Oriya : or	Tagalog : tl Bulgare : bg	Hindi latinisé : hi-Latn	Pendjabi : pa	Tamoul : ta Birman : my	Hongrois : hu	Pachtou : ps	Télougou : te Croate : hr	Islandais : is	Persan : fa	Thaï : th Catalan : ca	Indonésien : in	Polonais : pl	Tibétain : bo Tchèque : cs	Italien : it	Portugais : pt	Chinois traditionnel : zh-TW Danois : da	Japonais : ja	Roumain : ro	Turc : tr Néerlandais : nl	Kannada : kn	Russe : ru	Ukrainien : uk Anglais : en	Khmer : km	Serbe : sr	Ourdou : ur Estonien : et	Coréen : ko	Chinois simplifié : zh-CN	Ouïghour : ug Finnois : fi	Lao : lo	Sindhi : sd	Vietnamien : vi Français : fr	Letton : lv	Singhalais : si	Gallois : cy Géorgien : ka	Lituanien : lt