Créer une requête

​

Créer une requête

Limitations des requêtes !

Vos requêtes seront limitées en fonction du niveau d’accès que vous utilisez. 

Votre requête peut contenir 512 caractères pour les clients facturés à l’usage, ou jusqu’à 4 096 caractères pour les clients Enterprise.

Si vous avez un accès Enterprise, veuillez contacter votre chargé de compte. 

Disponibilité des opérateurs

La plupart des opérateurs sont disponibles pour tout développeur, mais certains sont réservés aux personnes ayant obtenu une validation pour un accès Enterprise. Nous indiquons dans le tableau des opérateurs le niveau d’accès requis pour chaque opérateur à l’aide des libellés suivants :

• Opérateurs de base : Disponibles avec n’importe quel Project.
• Opérateurs avancés : Disponibles avec un Project disposant d’un accès Enterprise.   

​

Types d’opérateurs : autonomes et nécessitant une conjonction

Les opérateurs autonomes peuvent être utilisés seuls ou avec n’importe quel autre opérateur (y compris ceux qui nécessitent une conjonction).

Par exemple, la requête suivante fonctionnera parce qu’elle utilise l’opérateur #hashtag, qui est autonome :

#xapiv2

Les opérateurs nécessitant une conjonction ne peuvent pas être utilisés seuls dans une requête ; ils ne peuvent être utilisés que lorsqu’au moins un opérateur autonome est inclus dans la requête. En effet, utiliser ces opérateurs seuls serait beaucoup trop général et renverrait un volume extrêmement élevé de Publications.

Par exemple, les requêtes suivantes ne sont pas prises en charge puisqu’elles ne contiennent que des opérateurs nécessitant une conjonction :

has:media has:links OR is:retweet

Si nous ajoutons un opérateur autonome, comme l’expression « X data », la requête fonctionnera alors correctement.

« X data » has:mentions (has:media OR has:links)

​

Opérateurs booléens et regroupement

Si vous souhaitez enchaîner plusieurs opérateurs dans une seule requête, vous disposez des outils suivants :

Logique AND	Des opérateurs successifs séparés par un espace produiront une logique booléenne « AND », ce qui signifie que les Publications ne correspondront que si les deux conditions sont remplies. Par exemple, snow day #NoSchool correspondra aux Publications contenant les termes snow et day et le hashtag #NoSchool.
Logique OR	Des opérateurs successifs séparés par OR produiront une logique OR, ce qui signifie que les Publications correspondront si l’une ou l’autre des conditions est remplie. Par exemple, en indiquant grumpy OR cat OR #meme, vous obtiendrez toutes les Publications contenant au moins les termes grumpy ou cat, ou le hashtag #meme.
Logique NOT, négation	Ajoutez un tiret (-) devant un mot-clé (ou tout opérateur) pour le nier (NOT). Par exemple, cat #meme -grumpy correspondra aux Publications contenant le hashtag #meme et le terme cat, mais uniquement si elles ne contiennent pas le terme grumpy. Une clause de requête courante est -is:retweet, qui ne correspondra pas aux Retweets, et ne correspondra donc qu’aux Publications originales, aux Quote Tweets et aux réponses. Tous les opérateurs peuvent être niés, mais les opérateurs niés ne peuvent pas être utilisés seuls.
Regroupement	Vous pouvez utiliser des parenthèses pour regrouper des opérateurs. Par exemple, (grumpy cat) OR (#meme has:images) renverra soit des Publications contenant les termes grumpy et cat, soit des Publications avec images contenant le hashtag #meme. Notez que les AND sont appliqués en premier, puis les OR sont appliqués.

Remarque sur les négations

Les opérateurs -is:nullcast doivent toujours être niés.

Les opérateurs niés ne peuvent pas être utilisés seuls.

Ne niez pas un ensemble d’opérateurs regroupés entre parenthèses. À la place, niez chaque opérateur individuellement. Par exemple, au lieu d’utiliser skiing -(snow OR day OR noschool), nous vous conseillons d’utiliser skiing -snow -day -noschool. 

Ordre d’évaluation

Lorsque vous combinez la logique AND et OR, l’ordre d’évaluation suivant détermine la façon dont votre requête est interprétée.

1. Les opérateurs reliés par une logique AND sont combinés en premier
2. Ensuite, les opérateurs reliés par une logique OR sont appliqués

Par exemple :

• apple OR iphone ipad sera évalué comme apple OR (iphone ipad)
• ipad iphone OR android sera évalué comme (iphone ipad) OR android

Pour éliminer toute incertitude et vous assurer que votre requête est évaluée comme prévu, regroupez les termes avec des parenthèses lorsque cela est approprié. 

Par exemple :

• (apple OR iphone) ipad
• iphone (ipad OR android)  

Ponctuation, diacritiques et sensibilité à la casse

Si vous indiquez un mot-clé ou un hashtag dans une requête avec des accents ou des diacritiques, il correspondra au texte de la Publication qui contient à la fois le terme avec accents et diacritiques, ainsi que ce même terme avec des caractères non accentués. Par exemple, des requêtes avec le mot-clé Diacrítica ou le hashtag #cumpleaños correspondront à Diacrítica ou #cumpleaños, ainsi qu’à Diacritica ou #cumpleanos sans tilde sur í ou eñe.

Les caractères avec accents ou diacritiques sont traités de la même manière que les caractères normaux et ne sont pas traités comme des limites de mots. Par exemple, une requête avec le mot-clé cumpleaños ne correspondrait qu’aux activités contenant le mot cumpleaños et ne correspondrait pas aux activités contenant cumplea, cumplean ou os.

Tous les opérateurs sont évalués de manière insensible à la casse. Par exemple, la requête cat correspondra aux Publications contenant toutes les variantes suivantes : cat, CAT, Cat.

Le comportement de correspondance du flux filtré diffère de celui des décomptes de Publications. Lors de la création d’une règle de flux filtré, sachez que les mots-clés et hashtags incluant des accents et des diacritiques ne correspondront qu’aux termes qui incluent également l’accent et le diacritique, et ne correspondront pas aux termes utilisant à la place des caractères normaux. 

Par exemple, des règles de flux filtré qui incluent le mot-clé Diacrítica ou le hashtag #cumpleaños ne correspondront qu’aux termes Diacrítica et #cumpleaños, et ne correspondront pas à Diacritica ou #cumpleanos sans tilde sur í ou eñe.

Spécificité et efficacité

Lorsque vous commencez à élaborer votre requête, il est important de garder quelques éléments à l’esprit.

• L’utilisation d’opérateurs génériques et isolés pour votre requête, comme un simple mot‑clé ou un #hashtag, n’est généralement pas recommandée, car cela correspondra probablement à un volume massif de Publications. Créer une requête plus robuste produira un ensemble plus spécifique de Publications correspondantes et, idéalement, augmentera la précision de vos décomptes de Publications afin de vous aider à dégager des insights plus pertinents. 
  • Par exemple, si votre requête est simplement le mot‑clé happy, vous obtiendrez probablement entre 200 000 et 300 000 Publications par jour.
  • L’ajout d’opérateurs conditionnels supplémentaires restreint vos résultats, par exemple (happy OR happiness) place_country:GB -birthday -is:retweet
• Rédiger des requêtes efficaces est également utile pour respecter la limite de longueur de la requête en nombre de caractères. Le nombre de caractères inclut l’intégralité de la chaîne de requête, y compris les espaces et les opérateurs.
  • Par exemple, la requête suivante comporte 59 caractères : (happy OR happiness) place_country:GB -birthday -is:retweet

Comportement de correspondance des Quote Tweets

Lorsque vous utilisez les endpoints de décompte de Publications, les opérateurs ne font pas correspondre le contenu de la Publication originale qui a été citée, mais correspondent au contenu inclus dans le Quote Tweet.

Cependant, veuillez noter que le flux filtré fera correspondre à la fois le contenu de la Publication originale citée et le contenu du Quote Tweet.  

Construction itérative d’une requête

Testez votre requête tôt et souvent

Obtenir dès la première fois une requête qui renvoie les « bons » résultats est rare. Il y a tellement de contenu sur X qui peut ou non être évident au premier abord, et la syntaxe de requête décrite ci‑dessus peut être difficile à aligner sur la requête souhaitée.

Lorsque vous construisez une requête, il est important de la tester périodiquement à l’aide de l’un des endpoints Search Post pour vérifier que les Publications qui correspondent à votre requête sont pertinentes pour votre cas d’usage.

Pour cette section, nous allons partir de la requête suivante et l’ajuster en fonction des résultats que nous obtenons pendant nos tests : 

happy OR happiness

Utiliser les résultats pour restreindre la requête

Lorsque vous testez la requête avec Search Posts, vous devez parcourir les Publications renvoyées pour vérifier qu’elles incluent les données que vous vous attendez à recevoir. Commencer par une requête large et un surensemble de Publications correspondantes vous permet d’examiner le résultat et de restreindre la requête afin de filtrer les résultats non souhaités.  

Lorsque nous avons testé la requête d’exemple, nous avons remarqué que nous recevions des Publications dans un grand nombre de langues différentes. Dans cette situation, nous voulons uniquement recevoir des Publications en anglais, nous allons donc ajouter l’opérateur lang: :

(happy OR happiness) lang:en

Le test a renvoyé un certain nombre de Publications souhaitant un joyeux anniversaire, nous allons donc ajouter -birthday en tant qu’opérateur de mot‑clé négatif. Nous voulons également ne recevoir que des Publications originales, nous avons donc ajouté l’opérateur négatif -is:retweet :

(happy OR happiness) lang:en -birthday -is:retweet

Ajuster pour inclure davantage lorsque nécessaire

Si vous constatez que vous ne recevez pas via Search Posts des données que vous attendiez, alors que vous savez qu’il existe des Publications qui devraient être renvoyées, vous devrez peut‑être élargir votre requête en supprimant des opérateurs qui filtrent les données souhaitées. 

Dans notre exemple, nous avons remarqué qu’il y avait d’autres Publications dans notre timeline personnelle qui exprimaient l’émotion recherchée mais n’étaient pas incluses dans les résultats de test. Pour garantir une meilleure couverture, nous allons ajouter les mots‑clés excited et elated.

(happy OR happiness OR excited OR elated) lang:en -birthday -is:retweet

Ajuster pour les tendances populaires/pics sur la période

Les tendances apparaissent et disparaissent rapidement sur X. Le maintien de votre requête doit être un processus actif. Si vous prévoyez d’utiliser une requête pendant un certain temps, nous vous conseillons de vérifier périodiquement les données que vous recevez afin de déterminer si des ajustements sont nécessaires.

Dans notre exemple, nous remarquons que nous avons commencé à recevoir des Publications souhaitant de « joyeuses fêtes ». Comme nous ne voulons pas que ces Publications soient incluses dans nos résultats, nous allons ajouter le mot‑clé négatif -holidays.

(happy OR happiness OR excited OR elated) lang:en -birthday -is:retweet -holidays 

Une fois que vous avez correctement testé et itéré votre requête, vous pouvez commencer à l’envoyer avec les endpoints de décompte de Publications afin de ne recevoir que le volume de Publications plutôt que l’intégralité des payloads de Publication.

​

Ajout d’une requête de recherche à votre appel

Pour ajouter votre requête de recherche à votre appel, vous devez utiliser le paramètre query. Comme pour tout paramètre de requête, vous devez vous assurer d’encoder en HTTP la requête de recherche que vous avez définie.

Voici un exemple de ce à quoi cela peut ressembler avec une commande cURL. Si vous souhaitez utiliser cette commande, veillez à remplacer $BEARER_TOKEN par votre propre Jeton Bearer :

      curl https://api.x.com/2/tweets/counts/recent?query=cat%20has%3Amedia%20-grumpy&tweet.fields=created_at&max_results=100 -H "Authorization: Bearer $BEARER_TOKEN"

​

Exemples de requêtes

Suivi d’une catastrophe naturelle

La requête suivante permettait de faire correspondre des Publications originales provenant d’agences météorologiques et de stations de mesure qui parlent de l’ouragan Harvey, qui a frappé Houston en 2017.

Voici à quoi ressemblerait la requête sans l’encodage HTTP :

has:geo (from:NWSNHC OR from:NHC_Atlantic OR from:NWSHouston OR from:NWSSanAntonio OR from:USGS_TexasRain OR from:USGS_TexasFlood OR from:JeffLindner1) -is:retweet

Et voici à quoi ressemblerait la requête avec l’encodage HTTP, le paramètre de requête et l’URI des décomptes récents de Publications :

https://api.x.com/2/tweets/counts/recent?query=-is%3Aretweet%20has%3Ageo%20(from%3ANWSNHC%20OR%20from%3ANHC_Atlantic%20OR%20from%3ANWSHouston%20OR%20from%3ANWSSanAntonio%20OR%20from%3AUSGS_TexasRain%20OR%20from%3AUSGS_TexasFlood%20OR%20from%3AJeffLindner1)

Analyse du sentiment d’une conversation

La règle suivante peut être utilisée pour mieux comprendre le sentiment de la conversation qui se développe autour du hashtag #nowplaying, mais limitée aux Publications publiées en Amérique du Nord.

Voici à quoi ressembleraient les deux requêtes différentes, l’une pour le positif et l’autre pour le négatif, sans l’encodage HTTP :

#nowplaying (happy OR exciting OR excited OR favorite OR fav OR amazing OR lovely OR incredible) (place_country:US OR place_country:MX OR place_country:CA) -horrible -worst -sucks -bad -disappointing

#nowplaying (horrible OR worst OR sucks OR bad OR disappointing) (place_country:US OR place_country:MX OR place_country:CA) -happy -exciting -excited -favorite -fav -amazing -lovely -incredible

Et voici à quoi ressemblerait la requête avec l’encodage HTTP, le paramètre de requête et l’URI des décomptes récents de Publications :

https://api.x.com/2/tweets/counts/recent?query=%23nowplaying%20(happy%20OR%20exciting%20OR%20excited%20OR%20favorite%20OR%20fav%20OR%20amazing%20OR%20lovely%20OR%20incredible)%20(place_country%3AUS%20OR%20place_country%3AMX%20OR%20place_country%3ACA)%20-horrible%20-worst%20-sucks%20-bad%20-disappointing

https://api.x.com/2/tweets/counts/recent?query=%23nowplaying%20(horrible%20OR%20worst%20OR%20sucks%20OR%20bad%20OR%20disappointing)%20(place_country%3AUS%20OR%20place_country%3AMX%20OR%20place_country%3ACA)%20-happy%20-exciting%20-excited%20-favorite%20-fav%20-amazing%20-lovely%20-incredible

Trouver des Publications liées à une annotation de Publication spécifique

Cette règle a été conçue pour filtrer les Publications originales qui incluent l’image d’un animal de compagnie qui n’est pas un chat, lorsque la langue identifiée dans la Publication est le japonais. Pour ce faire, nous avons utilisé l’opérateur context: pour tirer parti de la fonctionnalité Post annotation. Nous avons d’abord utilisé l’endpoint Post lookup et le paramètre de champs tweet.fields=context_annotations pour identifier les IDs domain.entity dont nous avons besoin dans notre requête :

• Les Publications liées aux chats renvoient le domain 66 (catégorie Interests and Hobbies) avec l’entity 852262932607926273 (Cats). 
• Les Publications liées aux animaux de compagnie renvoient le domain 65 (Interests and Hobbies Vertical) avec l’entity 852262932607926273 (Pets). 

Voici à quoi ressemblerait la requête sans l’encodage HTTP :

context:65.852262932607926273 -context:66.852262932607926273 -is:retweet has:images lang:ja

Et voici à quoi ressemblerait la requête avec l’encodage HTTP, le paramètre de requête et l’URI des décomptes récents de Publications :

https://api.x.com/2/tweets/counts/recent?query=context%3A65.852262932607926273%20-context%3A66.852262932607926273%20-is%3Aretweet%20has%3Aimages%20lang%3Aja

​

Opérateurs

Opérateur	type	Disponibilité	Description
keyword	Autonome	Essentiel	Correspond à 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 caractères de mot-clé 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 de base Unicode. Par exemple, une Publication contenant le texte « I like coca-cola » serait découpée en jetons comme suit : I, like, coca, cola. Ces jetons seraient ensuite comparés à la chaîne de caractères de mot-clé utilisée dans votre requête. Pour faire correspondre des chaînes contenant des signes de 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	Essentiel	Fait correspondre un émoji dans le corps d’une Publication. Comme pour un mot-clé, les émojis font l’objet d’une correspondance tokenisée, ce qui signifie que votre émoji sera comparé au texte tokenisé du corps de la Publication. Notez que si un émoji possède une variante, vous devez l’entourer de guillemets doubles pour l’ajouter à une requête. Exemple : (😃 OR 😡) 😬
"exact phrase match"	Autonome	Essentiel	Correspond à la phrase exacte présente dans le corps d’une Publication. Exemple : ("X API" OR #v2) -"recent counts"
#	Autonome	Essentiel	Fait correspondre toute Publication contenant un hashtag reconnu, si le hashtag est une entité reconnue dans une Publication. Cet opérateur effectue une correspondance exacte, PAS une correspondance basée sur la tokenisation, ce qui signifie que la règle #thanku correspondra aux publications contenant exactement le hashtag #thanku, mais pas à celles contenant le hashtag #thankunext. Exemple : #thankunext #fanart OR @arianagrande
@	Autonome	Essentiel	Fait correspondre toute Publication mentionnant le nom d’utilisateur indiqué, si ce nom d’utilisateur est une entité reconnue (y compris le caractère @). Exemple : (@XDevelopers OR @API) -@X
$	Autonome	Avancé	Correspond à toute Publication qui contient le « cashtag » spécifié (où le premier caractère du jeton est le caractère « $»). Remarque : l’opérateur de cashtag s’appuie sur l’extraction des entités « symbols » de X pour faire correspondre les cashtags, plutôt que d’essayer d’extraire le cashtag directement du corps du texte. Exemple : `$twtr OR @XDevelopers -$fb`
from:	Autonome	Essentiel	Correspond à 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. 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	Essentiel	Correspond à toute Publication en réponse à un utilisateur donné. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’id numérique de l’utilisateur. Vous ne pouvez fournir qu’un seul nom d’utilisateur/id par opérateur to:. Exemple : to:XDevelopers OR to:API -to:X
url:	Autonome	Essentiel	Effectue une correspondance tokenisée sur toute URL correctement mise en forme figurant dans une Publication. Cet opérateur peut effectuer 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.x.com) correspondra aux deux règles suivantes : from:XDevelopers url:"https://developer.x.com" et from:XDevelopers url:"https://t.co". Les jetons et les expressions contenant de la ponctuation ou des caractères spéciaux doivent être entourés de guillemets doubles.
retweets_of:	Autonome	Essentiel	Fait correspondre les Publications qui sont des Retweets de l’utilisateur indiqué. La valeur peut être soit le nom d’utilisateur (sans le caractère @), soit l’ID utilisateur numérique de cet utilisateur. Vous ne pouvez indiquer qu’un seul nom d’utilisateur/ID par opérateur retweets_of:. Exemple : retweets_of:XDevelopers OR retweets_of:API
context:	Autonome	Essentiel	Associe les Publications à une paire spécifique domain id/entity id. Vous ne pouvez transmettre qu’un seul domaine/entité par opérateur context:. Exemple : context:domain_id.entity_id. Vous pouvez combiner plusieurs domaines/entités à l’aide de l’opérateur OR : (context:47.113922 9372198469633 OR context:11.1088514520308342784)
entity:	Autonome	Essentiel	Associe des Publications à une valeur de chaîne pour une entité spécifique. Vous pouvez uniquement passer un seul opérateur entity:. Exemple : entity:"string declaration of entity/place". Veuillez noter que cette fonctionnalité n’est disponible qu’avec la recherche récente.
conversation_id:	Autonome	Essentiel	Renvoie les Publications qui partagent le même ID de conversation. Un ID de conversation correspond à l’ID de la Publication qui a démarré la conversation. Au fur et à mesure que des réponses à une Publication sont publiées, y compris les réponses à des réponses, le conversation_id est ajouté au payload JSON de chacune d’elles. Vous ne pouvez transmettre qu’un seul ID de conversation par opérateur conversation_id:. Exemple : conversation_id:1334987486343299072 (from:XDevelopers OR from:API)
list:	Autonome	Avancé	Correspond aux Publications publiées par des utilisateurs qui sont membres d’une Liste spécifiée. Par exemple, si @XDevelopers et @API étaient membres de la Liste 123 et que vous ajoutiez list:123 à votre requête, votre réponse ne contiendrait que des Publications qui ont été publiées par ces comptes. Vous pouvez trouver les ID de Liste en utilisant l’endpoint de recherche de Liste. Exemple : list:123
place:	Autonome	Avancé	Renvoie les Publications associées à l’emplacement spécifié ou à l’ID de lieu X indiqué. Les noms de lieux comportant plusieurs mots (« New York City », « Palo Alto ») doivent être placés entre guillemets. Vous ne pouvez indiquer 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 IDs de lieu X. Exemple : place:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:	Autonome	Avancé	Fait correspondre les Publications pour lesquelles le code pays associé à un lieu/emplacement tagué correspond au code ISO alpha-2 indiqué. Vous pouvez trouver une liste des codes ISO valides sur Wikipédia. Vous ne pouvez fournir 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	Avancé	Correspond à l’objet place.geo.coordinates de la Publication lorsque présent et, dans X, à un polygone géographique de lieu, lorsque ce polygone 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. Exemple : point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]
bounding_box:	Autonome	Avancé	Fait correspondre l’objet place.geo.coordinates de la Publication lorsqu’il est présent et, dans X, le polygone géographique d’un lieu, lorsque ce 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 bounding box doivent être inférieures à 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 la règle sont contenus entre crochets et séparés par des espaces. Exemple : bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweet	Conjonction requise	Standard	Sélectionne les Retweets qui correspondent au reste de la règle spécifiée. Cet opérateur ne prend en compte que les véritables Retweets (par exemple ceux générés à l’aide du bouton Retweet). Les Tweets cités ne seront pas pris en compte par cet opérateur. Exemple : data @XDevelopers -is:retweet
is:reply	Conjonction requise	Standard	Renvoie uniquement les réponses explicites qui correspondent à une règle. Peut également être utilisé en négation pour exclure des résultats les réponses qui correspondent à une requête. Remarque : cet opérateur est également disponible avec l’endpoint de flux filtré. Lorsqu’il est utilisé avec le flux filtré, cet opérateur fait correspondre les réponses à une Publication originale, les réponses dans des Publications citées et les réponses dans des Retweets. Exemple : from:XDevelopers is:reply
is:quote	Conjonction requise	Standard	Renvoie tous les Quote Tweets, aussi appelés Publications commentées. Exemple : "sentiment analysis" is:quote
is:verified	Conjonction requise	Standard	Renvoie uniquement les Publications dont les auteurs sont vérifiés sur X. Exemple : #nowplaying is:verified
-is :nullcast	Conjonction requise	Avancé	Supprime les Publications créées uniquement à des fins promotionnelles sur ads.x.com et ayant "source":"Twitter for Advertisers (legacy)" ou "source":"Twitter for Advertisers". Cet opérateur doit être utilisé sous forme négative. Pour plus d’informations sur les Publications nullcast, consultez notre page sur la disponibilité des Publications. Exemple : "mobile games" -is:nullcast
has:hashtags	Conjonction requise	Standard	Renvoie les Publications contenant au moins un hashtag. Exemple : from:XDevelopers -has:hashtags
has:cashtags	Conjonction requise	Avancé	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 requise	Standard	Cet opérateur renvoie les Publications qui contiennent des liens et des médias dans le corps de la Publication. Exemple : from:XDevelopers announcement has:links
has:mentions	Conjonction requise	Standard	Correspond aux Publications qui mentionnent un autre utilisateur X. Exemple : #nowplaying has:mentions
has:media	Conjonction requise	Standard	Renvoie les Publications qui contiennent un élément média, comme une photo, un GIF ou une vidéo, tels que déterminés par X. Cela ne renverra 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 requise	Standard	Identifie les Publications qui contiennent une URL reconnue pointant vers une image. Exemple : #meme has:images
has:videos	Conjonction requise	Standard	Correspond aux Publications qui contiennent des vidéos natives X, mises en ligne directement sur X. Cet opérateur ne renverra pas les vidéos créées avec Periscope, ni les Publications comportant des liens vers d’autres sites d’hébergement de vidéos. Exemple : #icebucketchallenge has:videos
has:geo	Conjonction requise	Avancé	Renvoie les Publications qui disposent de données de géolocalisation propres à la Publication, fournies par l’utilisateur d’X. Il peut s’agir soit d’un emplacement sous la forme d’un lieu X, avec le nom d’affichage correspondant, un polygone géospatial et d’autres champs, soit, dans de rares cas, d’une coordonnée géographique latitude-longitude. Remarque : les opérateurs qui font une correspondance sur 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 requise	Standard	Renvoie les 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). Il est important de noter que chaque Publication est actuellement classée dans une seule langue, donc combiner plusieurs langues avec l’opérateur AND ne renverra aucun résultat. Vous ne pouvez transmettre 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

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épalais : ne	Espagnol : es
Bengali : bn	Hébreu : iw	Norvégien : no	Suédois : sv
Bosniaque : bs	Hindi : hi	Odia (oriya) : or	Tagalog : tl
Bulgare : bg	Hindi latinisé : hi-Latn	Pendjabi : pa	Tamoul : ta
Birman : my	Hongrois : hu	Pachto : 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