keyword | Autonome | Core | Correspond à un mot-clé dans le corps d’un Post. Il s’agit d’une correspondance tokenisée, ce qui signifie que votre chaîne de mot-clé sera comparée au texte tokenisé du corps du Post. La tokenisation divise les mots en fonction de la ponctuation, des symboles et des caractères de séparation du plan de base Unicode. Par exemple, un Post avec le texte « I like coca-cola » serait divisé en tokens suivants : I, like, coca, cola. Ces tokens seraient ensuite comparés à la chaîne de mot-clé utilisée dans votre requête. Pour correspondre aux chaînes contenant de la ponctuation (par exemple coca-cola), des symboles ou des caractères de séparation, vous devez entourer votre mot-clé de guillemets doubles. Exemple : pepsi OR cola OR "coca cola" |
emoji | Autonome | Core | Correspond à un emoji dans le corps d’un Post. Similaire à un mot-clé, les emojis sont une correspondance tokenisée, ce qui signifie que votre emoji sera comparé au texte tokenisé du corps du Post. Notez que si un emoji a une variante, vous devez l’entourer de guillemets doubles pour l’ajouter à une requête. Exemple : (😃 OR 😡) 😬 |
"exact phrase match" | Autonome | Core | Correspond à la phrase exacte dans le corps d’un Post. Exemple : ("X API" OR #v2) -"recent counts" |
# | Autonome | Core | Correspond à tout Post contenant un hashtag reconnu, si le hashtag est une entité reconnue dans un Post. Cet opérateur effectue une correspondance exacte, NON une correspondance tokenisée, ce qui signifie que la règle #thanku correspondra aux posts avec le hashtag exact #thanku, mais pas à ceux avec le hashtag #thankunext. Exemple : #thankunext #fanart OR @arianagrande |
@ | Autonome | Core | Correspond à tout Post qui mentionne le nom d’utilisateur donné, si le nom d’utilisateur est une entité reconnue (incluant le caractère @). Exemple : (@XDevelopers OR @API) -@X |
$ | Autonome | Advanced | Correspond à tout Post qui contient le « cashtag » spécifié (où le caractère initial du token est le caractère « »). Notez que l'opérateur cashtag s'appuie sur l'extraction d'entité « symbols » de X pour correspondre aux cashtags, plutôt que d'essayer d'extraire le cashtag du corps lui-même. Exemple : `twtr OR @XDevelopers -$fb` |
from: | Autonome | Core | Correspond à tout Post d’un utilisateur spécifique. La valeur peut être soit le nom d’utilisateur (excluant le caractère @) soit l’ID utilisateur numérique de l’utilisateur. Vous ne pouvez passer qu’un seul nom d’utilisateur/ID par opérateur from:. Exemple : from:XDevelopers OR from:API -from:X |
to: | Autonome | Core | Correspond à tout Post qui est en réponse à un utilisateur particulier. La valeur peut être soit le nom d’utilisateur (excluant le caractère @) soit l’ID utilisateur numérique de l’utilisateur. Vous ne pouvez passer qu’un seul nom d’utilisateur/ID par opérateur to:. Exemple : to:XDevelopers OR to:API -to:X |
url: | Autonome | Core | Effectue une correspondance tokenisée sur toute URL correctement formatée d’un Post. Cet opérateur peut correspondre au contenu des champs url ou expanded_url. Par exemple, un Post contenant « You should check out X Developer Labs: https://t.co/c0A36SWil4 » (avec l’URL courte redirigeant vers https://developer.x.com) correspondra aux deux règles suivantes : from:XDevelopers url:"https://developer.x.com" et from:XDevelopers url:"https://t.co". Les tokens et phrases contenant de la ponctuation ou des caractères spéciaux doivent être entre guillemets doubles. |
retweets_of: | Autonome | Core | Correspond aux Posts qui sont des Retweets de l’utilisateur spécifié. La valeur peut être soit le nom d’utilisateur (excluant le caractère @) soit l’ID utilisateur numérique de l’utilisateur. Vous ne pouvez passer qu’un seul nom d’utilisateur/ID par opérateur retweets_of:. Exemple : retweets_of:XDevelopers OR retweets_of:API |
context: | Autonome | Core | Correspond aux Posts avec une paire ID de domaine/ID d’entité spécifique. Vous ne pouvez passer qu’un seul domaine/entité par opérateur context:. Exemple : context:domain_id.entity_id. Vous pouvez combiner plusieurs domaines/entités en utilisant l’opérateur OR : (context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | Autonome | Core | Correspond aux Posts avec une valeur de chaîne d’entité spécifique. Vous ne pouvez passer qu’un seul opérateur entity:. Exemple : entity:"string declaration of entity/place". Veuillez noter que ceci n’est disponible qu’avec la recherche récente. |
conversation_id: | Autonome | Core | Correspond aux Posts qui partagent un ID de conversation commun. Un ID de conversation est défini sur l’ID de Post d’un Post qui a commencé une conversation. Lorsque des réponses à un Post sont publiées, même des réponses aux réponses, le conversation_id est ajouté à sa charge utile JSON. Vous ne pouvez passer qu’un seul ID de conversation par opérateur conversation_id:. Exemple : conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | Autonome | Advanced | Correspond aux Posts publiés par des utilisateurs qui sont membres d’une List spécifiée. Par exemple, si @XDevelopers et @API étaient membres de la List 123, et que vous incluiez list:123 dans votre requête, votre réponse ne contiendra que les Posts qui ont été publiés par ces comptes. Vous pouvez trouver les ID de List en utilisant l’endpoint de recherche de List. Exemple : list:123 |
place: | Autonome | Advanced | Correspond aux Posts étiquetés avec l’emplacement spécifié ou l’ID de lieu X. Les noms de lieux composés de plusieurs mots (« New York City », « Palo Alto ») doivent être entourés de guillemets. Vous ne pouvez passer qu’un seul lieu par opérateur place:. Note : Voir l’endpoint GET geo/search Standard v1.1 pour savoir comment obtenir les ID de lieu X. Exemple : place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | Autonome | Advanced | Correspond aux Posts où le code pays associé à un lieu/emplacement étiqueté correspond au code de caractère alpha-2 ISO donné. Vous pouvez trouver une liste de codes ISO valides sur Wikipedia. Vous ne pouvez passer qu’un seul code ISO par opérateur place_country:. Exemple : place_country:US OR place_country:MX OR place_country:CA |
point_radius: | Autonome | Advanced | Correspond à l’objet place.geo.coordinates du Post lorsqu’il est présent, et dans X, à un polygone géographique de lieu, où 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 la plage de ±180. La latitude est dans la plage de ±90. Toutes les coordonnées sont en degrés décimaux. Les arguments de règle sont contenus dans des crochets, délimités par des espaces. Exemple : point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | Autonome | Advanced | Correspond à l’objet place.geo.coordinates du Post lorsqu’il est présent, et dans X, à un polygone géographique de lieu, où le polygone de lieu est entièrement contenu dans la région définie. bounding_box:[west_long south_lat east_long north_lat]. La largeur et la hauteur de la boîte englobante doivent être inférieures à 25 mi. La longitude est dans la plage de ±180. La latitude est dans la plage de ±90. Toutes les coordonnées sont en degrés décimaux. Les arguments de règle sont contenus dans des crochets, délimités par des espaces. Exemple : bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | Conjonction requise | Core | Correspond aux Retweets qui correspondent au reste de la règle spécifiée. Cet opérateur ne recherche que les vrais Retweets (par exemple, ceux générés en utilisant le bouton Retweet). Les Quote Tweets ne seront pas trouvés par cet opérateur. Exemple : data @XDevelopers -is:retweet |
is:reply | Conjonction requise | Core | Livre uniquement les réponses explicites qui correspondent à une règle. Peut également être nié pour exclure les réponses qui correspondent à une requête de la livraison. Note : Cet opérateur est également disponible avec l’endpoint de flux filtré. Lorsqu’il est utilisé avec le flux filtré, cet opérateur correspond aux réponses à un Post original, aux réponses dans les Posts cités, et aux réponses dans les Retweets. Exemple : from:XDevelopers is:reply |
is:quote | Conjonction requise | Core | Retourne tous les Quote Tweets, également connus sous le nom de Posts avec commentaires. Exemple : "sentiment analysis" is:quote |
is:verified | Conjonction requise | Core | Livre uniquement les Posts dont les auteurs sont vérifiés par X. Exemple : #nowplaying is:verified |
-is :nullcast | Conjonction requise | Advanced | Supprime les Posts créés uniquement pour la promotion sur ads.x.com qui ont un "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 Posts Nullcast, consultez notre page sur la disponibilité des Posts. Exemple : "mobile games" -is:nullcast |
has:hashtags | Conjonction requise | Core | Correspond aux Posts qui contiennent au moins un hashtag. Exemple : from:XDevelopers -has:hashtags |
has:cashtags | Conjonction requise | Advanced | Correspond aux Posts qui contiennent un symbole cashtag (avec un caractère ‘' en préfixe. Par exemple, `tag). Exemple : #stonks has:cashtags` |
has:links | Conjonction requise | Core | Cet opérateur correspond aux Posts qui contiennent des liens et des médias dans le corps du Post. Exemple : from:XDevelopers announcement has:links |
has:mentions | Conjonction requise | Core | Correspond aux Posts qui mentionnent un autre utilisateur X. Exemple : #nowplaying has:mentions |
has:media | Conjonction requise | Core | Correspond aux Posts qui contiennent un objet média, tel qu’une photo, un GIF ou une vidéo, tel que déterminé par X. Cela ne correspondra pas aux médias créés avec Periscope, ni aux Posts avec des liens vers d’autres sites d’hébergement de médias. Exemple : (kittens OR puppies) has:media |
has:images | Conjonction requise | Core | Correspond aux Posts qui contiennent une URL reconnue vers une image. Exemple : #meme has:images |
has:videos | Conjonction requise | Core | Correspond aux Posts qui contiennent des vidéos X natives, téléchargées directement sur X. Cela ne correspondra pas aux vidéos créées avec Periscope, ni aux Posts avec des liens vers d’autres sites d’hébergement vidéo. Exemple : #icebucketchallenge has:videos |
has:geo | Conjonction requise | Advanced | Correspond aux Posts qui ont des données de géolocalisation spécifiques au Post fournies par l’utilisateur X. Cela peut être soit un lieu sous la forme d’un lieu X, avec le nom d’affichage correspondant, le polygone géographique et d’autres champs, soit dans de rares cas, une coordonnée géographique latitude-longitude. Remarque : Les opérateurs correspondant au lieu (géo du Post) n’incluront que les correspondances des Posts originaux. Les Retweets ne contiennent aucune donnée de lieu. Exemple : recommend #paris has:geo -bakery |
lang: | Conjonction requise | Core | Correspond aux Posts qui ont été classifiés par X comme étant d’une langue particulière (si, et seulement si, le Post a été classifié). Il est important de noter que chaque Post n’est actuellement classifié que comme étant d’une seule langue, donc l’utilisation de l’opérateur AND avec plusieurs langues ne donnera aucun résultat. Vous ne pouvez passer 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 fourni est ‘und’ (pour indéfini). Exemple : recommend #paris lang:en |
