Premiers pas avec les règles et requêtes Enterprise
OR en majuscules.
Chaque règle peut contenir jusqu’à 2 048 caractères, sans limite quant au nombre de clauses positives (éléments que vous souhaitez inclure dans la correspondance ou le filtrage) et de clauses négatives (éléments que vous souhaitez exclure et ne pas faire correspondre).
Création de règles et de requêtes
social
Combiner des termes avec un espace
Ajouter un autre mot-clé revient à ajouter une autre condition pour trouver des correspondances. Par exemple, cette règle ne ferait correspondre que les activités où « social » et « media » sont tous les deux présents dans le texte, dans n’importe quel ordre – le fait d’avoir un espace entre les termes fonctionne comme une logique booléenne AND. Si vous incluez un AND explicite dans votre règle, il sera rejeté par le point de terminaison des règles.
social media
Combiner des termes avec OR en majuscules
De nombreuses situations nécessitent cependant une logique booléenne OR. Cela est aussi très simple à réaliser. Remarquez que l’opérateur OR doit être en majuscules et qu’un « or » en minuscules sera traité comme un mot-clé ordinaire.
social OR data
Négation de termes
D’autres scénarios peuvent nécessiter l’exclusion de résultats contenant certains mots-clés (logique booléenne NOT). Par exemple, des activités avec « happy », mais en excluant celles contenant « birthday » dans le texte.
social -personality
Regroupement avec des parenthèses
Ces types de logique peuvent être combinés en utilisant le regroupement avec des parenthèses et étendus à des requêtes beaucoup plus complexes.
(social OR data) (academic OR research) -personality -information -university
Ce n’est cependant qu’un début – bien que les exemples ci‑dessus reposent simplement sur une mise en correspondance tokenisée des mots-clés, les produits Enterprise offrent également des opérateurs pour effectuer différents types de correspondance sur le texte.
Correspondance exacte
"social media research"
Correspondance par sous-chaîne
contains:info
Correspondance par proximité
"social media research"~3
En outre, d’autres opérateurs vous permettent de filtrer selon des aspects uniques des données sociales, au‑delà du simple texte.
L’utilisateur qui publie une Publication
from:XDeveloeprs
Tweets géolocalisés dans un rayon de 10 miles autour de Pearl St. à Boulder, CO, États-Unis
point_radius:[-105.27346517 40.01924738 10.0mi]
Combiner tous les éléments
Ceux‑ci peuvent être combinés avec des filtres de texte en utilisant les mêmes types de logique que ceux décrits ci‑dessus.
(social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university
Syntaxe booléenne
| Type de logique | Syntaxe de l’opérateur | Description |
| AND | social data | L’espace entre deux opérateurs entraîne une logique AND entre eux Fait correspondre les activités contenant les deux mots‑clés (« social », « data »). N’utilisez pas AND explicitement dans votre règle. Utilisez uniquement l’espace. Un AND explicite sera traité comme un mot‑clé classique. |
| OR | social OR data | Pour appliquer OR entre deux opérateurs, insérez un OR en majuscules, entouré d’espaces, entre eux Fait correspondre les activités contenant L’UN OU L’AUTRE des mots‑clés (« social » OU « data ») Notez que si vous combinez les logiques OR et AND dans une seule règle, vous devez comprendre l’ordre des opérations décrit dans notre section « Order of operations » et envisager de regrouper les opérateurs non négatifs à l’aide de parenthèses, comme décrit ci‑dessous, afin de vous assurer que votre règle se comporte comme prévu. Vous devez utiliser « OR » en majuscules dans votre règle. Le « or » en minuscules sera traité comme un mot‑clé classique. |
| NOT | social data -apple -android -phone | Insérez un caractère - immédiatement devant l’opérateur ou le groupe d’opérateurs. La règle d’exemple affichée fait correspondre les activités contenant le mot‑clé « social », mais exclut celles qui contiennent le mot‑clé « data ». Les OR négatifs ne sont pas autorisés lorsque la règle demanderait « tout dans le firehose sauf la négation ». Par exemple, apple OR -ipad est invalide car cela ferait correspondre toutes les activités sauf celles mentionnant « ipad ». |
| Regroupement | (social OR data) -XDeveloeprs -api | Les parenthèses autour de plusieurs opérateurs créent un « groupe » fonctionnel. Les groupes peuvent être reliés à des clauses de la même manière qu’une clause individuelle via l’espace (AND) ou des OR. Toutefois, il est recommandé de ne pas regrouper les négations en appliquant le préfixe de négation - à l’ensemble du groupe. Vous devez plutôt négativer chaque opérateur individuellement, en les enchaînant via l’espace (AND). Par exemple, au lieu d’utiliser -(iphone OR imac OR macbook), utilisez ce qui suit : -iphone -imac -macbook Le regroupement est particulièrement important lorsqu’une seule règle combine les logiques AND et OR, en raison de l’ordre des opérations utilisé pour évaluer la règle. Voir ci‑dessous pour plus de détails. |
has:hashtags signifie « Je veux des activités contenant des hashtags. »
Les opérateurs négatifs définissent ce que vous souhaitez exclure des résultats et sont créés en utilisant la logique booléenne NOT décrite ci‑dessus. Par exemple, -has:hashtags signifie « Exclure toute activité contenant des hashtags, même si elle correspond par ailleurs à ma règle. »
Les produits d’opérateurs Premium n’ont aucune restriction sur le nombre de clauses positives et négatives, sous réserve d’une longueur maximale de 2 048 caractères.
Ordre des opérations
- Les opérateurs connectés par la logique AND sont d’abord combinés
- Ensuite, les opérateurs connectés par la logique OR sont appliqués
apple OR iphone ipadsera évalué commeapple OR (iphone ipad)ipad iphone OR androidsera évalué comme(iphone ipad) OR android
(apple OR iphone) ipadiphone (ipad OR android)
Ponctuation, signes diacritiques et sensibilité à la casse
Diacr**í**tica ou un hashtag #cumplea**ñ**os correspondra à « Diacrítica » ou « #cumpleaños », mais pas à « Diacritica » ou « #cumpleanos » sans la tilde sur í ou sans le eñe.
Les caractères accentués ou comportant des signes diacritiques sont traités de la même façon que les autres caractères et ne sont pas considérés comme des délimiteurs de mots. Par exemple, une règle 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 sans tenir compte de la casse. Par exemple, la règle Cat correspondra à tous les éléments suivants : « cat », « CAT », « Cat ».
Comme décrit sur notre page « Matching rules », chaque règle peut être créée avec une balise. Ces balises n’ont aucun effet sur le filtrage, mais peuvent être utilisées pour créer des regroupements logiques de règles au sein de votre App. Chaque règle ne peut avoir qu’une seule balise, avec une longueur maximale de 255 caractères. Les balises sont incluses avec la règle au format JSON lors de leur création via l’API, comme décrit sur notre page « Matching rules ».
Formatage des règles en JSON
{"value":"insert_rule_here"}
Règles avec des guillemets doubles
Si la règle contient des caractères de guillemet double (“) associés à des correspondances exactes ou à d’autres opérateurs, ils doivent être échappés avec une barre oblique inverse afin de les distinguer de la structure du format JSON.
"social data" @XDevelopers
La règle au format JSON serait :
{"value":"\"social data\" @XDevelopers"}
Règles avec des littéraux de chaîne contenant des guillemets doubles
Pour inclure un caractère de guillemet double comme littéral de chaîne dans une correspondance exacte, il doit être échappé deux fois. Par exemple, pour une règle correspondant exactement à la phrase “Toys “R” Us”, incluant les guillemets doubles autour de “R”, la représentation en texte brut ressemblerait à ceci :
"Toys \"R\" Us"
En convertissant cela au format JSON, vous devez utiliser la structure suivante :
{"value":"\"Toys \\\"R\\\" Us\""}
Règles avec des tags
Pour inclure un tag facultatif avec votre règle, comme décrit ci-dessus, il suffit d’ajouter un champ tag supplémentaire avec la valeur de la règle.
{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}
Formatage pour les requêtes API
Lorsque vous ajoutez ou supprimez des règles du flux via l’API, plusieurs règles au format JSON doivent être séparées par des virgules et encapsulées dans un tableau JSON rules, comme illustré ci-dessous :
{"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}
Opérateurs correspondant aux Tweets cités
KeywordsPhrasesProximity#hashtags@mentions$cashtagsurl:url_contains:has:linkshas:mentionshas:hashtagshas:mediahas:symbolsis:quoteis:reply
Opérateurs Enterprise
| Opérateur | Description |
|---|---|
| Mot-clé | Correspond à un mot-clé présent dans le corps du texte ou l’URL d’une Publication. Les mots-clés doivent commencer par un chiffre (0-9) ou par tout caractère autre qu’un signe de ponctuation. La correspondance de mots-clés est tokenisée, ce qui signifie que le mot-clé est comparé au texte du corps de la Publication après tokenisation. Pour les chaînes de caractères contenant de la ponctuation (par exemple, “coca-cola”), utilisez une “recherche de phrase exacte” entre guillemets. Exemple : (social OR pizza OR wildfire) -planet |
| emoji | Correspond à un emoji présent dans le corps d’une Publication, en utilisant une mise en correspondance tokenisée basée sur la ponctuation, les symboles/emoji et les caractères séparateurs. Si un emoji possède une variante, utilisez des guillemets pour les correspondances exactes. Exemple : (🍕 OR 💜 OR 🐢) -🤖 |
| ”correspondance exacte de la phrase” | Correspond à une expression exacte dans le corps d’une Publication. La ponctuation est traitée comme des espaces. Exemple : ("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth" |
| # | Correspond à toute Publication avec le hashtag spécifié. Il s’agit d’une correspondance exacte, ce qui signifie que #2016 correspondra aux Publications avec #2016 mais pas #2016election.Exemple : (#social OR #pizza OR #2016election) -#planet |
| @ | Correspond à toute Publication qui mentionne le nom d’utilisateur spécifié. Exemple : (@XDevelopers OR @api OR @twittereng) -@jack |
| ”keyword1 keyword2”~N | Opérateur de proximité qui retourne les Publications dont les mots-clés sont distants d’au plus N tokens les uns des autres. Les mots-clés dans l’ordre inverse ne peuvent être séparés que par au plus N-2 tokens. N ne peut pas être supérieur à 6. Exemple : "social media"~5 OR "API"~3 |
| contains: | Correspondance de sous-chaîne pour les Publications dont le corps contient la sous-chaîne spécifiée, indépendamment de la tokenisation. Utilisez des guillemets doubles pour les sous-chaînes contenant des espaces ou de la ponctuation. Exemple : (contains:social OR contains:"wikipedia.com") -contains:"buy now" |
| from: | Fait correspondre toute Publication provenant d’un utilisateur donné, en fonction de son id de compte X numérique ou de son nom d’utilisateur (sans @).Exemple : (from:2244994945 OR from:api OR from:twittereng) -from:jack |
| to: | Fait correspondre toute Publication en réponse à un utilisateur spécifique, identifié par son X Account ID numérique ou par son nom d’utilisateur (sans @).Exemple : (to:2244994945 OR to:api OR to:twittereng) -to:jack |
| url: | Effectue une recherche tokenisée (mot-clé/phrase) dans les URL développées d’une publication. Exemple : @XDevelopers url:"developer.x.com" |
| url_title: | Effectue une correspondance de mot-clé/phrase sur la balise HTML <title> de l’URL développée.Disponible uniquement avec PowerTrack et Historical PowerTrack. |
| url_description: | Effectue une recherche de mot-clé ou d’expression dans les métadonnées de description de la page étendue. Disponible uniquement avec PowerTrack et Historical PowerTrack. |
| url_contains: | Fait correspondre les Publications dont les URL contiennent la phrase ou le mot-clé spécifié. Entourez de guillemets les termes de recherche contenant des signes de ponctuation. Exemple : (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit |
| bio: | Identifie un mot-clé ou une expression dans la bio de l’utilisateur d’une Publication. Il s’agit d’une correspondance tokenisée sur le champ ‘description’ de l’objet User. Exemple : (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:trollRemarque : uniquement disponible avec PowerTrack et Historical PowerTrack. |
| bio_name: | Fait correspondre un mot-clé dans le nom de profil de l’utilisateur d’une Publication. Il s’agit d’une correspondance tokenisée dans le champ « name » d’un utilisateur dans l’objet User. Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
| bio_location: | Fait correspondre les Publications pour lesquelles l’emplacement de l’objet User contient le mot-clé ou la phrase spécifié(e). Cet opérateur effectue une correspondance tokenisée, similaire aux règles de mots-clés standard appliquées au corps du message. Cet emplacement fait partie de l’objet User et correspond à l’emplacement « d’origine » du compte. Remarque : Uniquement disponible avec PowerTrack et Historical PowerTrack. |
| statuses_count: | Fait correspondre des Publications lorsque l’auteur a publié un nombre de statuts dans l’intervalle donné. Si un seul nombre est spécifié, tout nombre supérieur ou égal sera pris en compte. Un intervalle peut être spécifié pour faire correspondre n’importe quel nombre dans cet intervalle (par ex. statuses_count:1000..10000).Exemple : to:api statuses_count:10Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
| followers_count: | Fait correspondre des Publications lorsque l’auteur a un nombre d’abonnés compris dans l’intervalle indiqué. Si un nombre unique est spécifié, tout nombre supérieur ou égal sera pris en compte. Un intervalle peut être spécifié pour faire correspondre tout nombre dans cet intervalle (par exemple, followers_count:1000..10000).Remarque : Uniquement disponible avec PowerTrack et Historical PowerTrack. |
| friends_count: | Correspond aux Publications dont l’auteur a un nombre d’amis (le nombre d’utilisateurs qu’il suit) compris dans la plage indiquée. Si un seul nombre est spécifié, tout nombre supérieur ou égal sera pris en compte. Vous pouvez spécifier une plage pour faire correspondre n’importe quel nombre de cette plage (par exemple, friends_count:1000..10000).Remarque : uniquement disponible avec PowerTrack et Historical PowerTrack. |
| listed_count: | Fait correspondre des Publications lorsque l’auteur a été ajouté à des Listes sur X un certain nombre de fois dans l’intervalle spécifié. Si un seul nombre est indiqué, toute valeur supérieure ou égale sera prise en compte. Un intervalle peut être indiqué pour faire correspondre n’importe quel nombre compris dans cet intervalle (par exemple, listed_count:10..100).Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
| $ | Identifie toute Publication contenant l’entité « cashtag » spécifiée. Exemple : ($TWTR OR $TSLA OR $BRK.A) -$FRemarque : l’opérateur de cashtag s’appuie sur l’extraction de l’entité « symbols » par X pour faire correspondre les cashtags, plutôt que de les extraire directement du corps de la Publication. |
| retweets_of: | Fait correspondre les Publications qui sont des Retweets d’un utilisateur spécifié. Accepte à la fois les noms d’utilisateur et les id numériques de compte X (et non les id de statut de Publication). Exemple : (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack |
| retweets_of_status_id: | Ne renvoie que les Retweets explicites de la Publication spécifiée. Utilisez l’identifiant d’une Publication originale et non celui d’un Retweet. Exemple : retweets_of_status_id:1293593516040269825Remarque : uniquement disponible avec PowerTrack et Historical PowerTrack. |
| in_reply_to_status_id: | Renvoie uniquement les réponses explicites à la Publication spécifiée. Exemple : in_reply_to_status_id:1293593516040269825Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
| sample: | Renvoie un échantillon aléatoire de Publications correspondant à une règle. Le taux d’échantillonnage doit être un entier compris entre 1 et 100. L’opérateur réduit le périmètre à X %, puis la règle/le filtre est appliqué à ce sous-ensemble échantillonné. Exemple : #happybirthday sample:5"happy birthday"~5 sample:80Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
| source: | Correspond à toute Publication générée par l’application source spécifiée. La valeur peut être le nom de l’application ou l’URL de l’application. Exemple : #happybirthday source:"X for iPhone""This is a test X from my TestingApp" source:MyTestAppNameRemarque : L’opérateur source effectue une recherche sur l’attribut de source de la Publication et ne peut pas être utilisé seul. |
| lang: | Correspond aux Publications que X a classées dans une langue donnée. Les Publications ne sont actuellement classées que dans une seule langue, donc rechercher plusieurs langues ne renvoie aucun résultat. Il est déconseillé de l’utiliser seul. |
| 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 | Panjabi : 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 | Sinhala : si | Gallois : cy |
| Géorgien : ka | Lituanien : lt |
lang. Voir ici pour plus d’informations sur les attributs JSON des entités X. Si aucune classification de langue ne peut être effectuée pour une Publication, la valeur lang de la Publication sera définie à « und » (pour « indéfini »).
| Opérateur | Description |
|---|---|
| place | Renvoie les Publications marquées avec l’emplacement spécifié ou l’id de lieu X correspondant.Les noms de lieu comportant plusieurs mots doivent être placés entre guillemets. Exemple : (place:London OR place:"Great Britain") -place:USAplace:fd70c22040963ac7Remarque : Consultez le point de terminaison d’API public GET geo/search pour savoir comment obtenir des id de lieu X.Remarque : Ne renvoie aucun résultat pour les Retweets ou les Quote Tweets, car les lieux des Retweets sont rattachés à la Publication d’origine. |
| place_country | Fait correspondre les Publications pour lesquelles le code pays associé à un lieu/emplacement étiqueté correspond au code ISO alpha-2 à deux lettres fourni. Exemple : place_country:GB OR place_country:AU OR place_country:CARemarque : ne correspond pas aux Retweets ni aux Tweets cités, car les lieux des Retweets sont rattachés à la Publication d’origine. Codes ISO valides : ISO 3166-1 alpha-2. |
| point_radius:[lon lat radius] | Fait correspondre l’emplacement exact (x,y) de la Publication ou un polygone géographique « Place » dans le rayon défini. * Rayon : < 25 mi * Unités prises en charge : mi, km * Longitude : ±180 * Latitude : ±90 Les coordonnées sont en degrés décimaux. Les arguments sont entre crochets, séparés par des espaces. Exemple : point_radius:[-105.27346517 40.01924738 0.5mi]Exemple : point_radius:[2.355128 48.861118 16km]Remarque : Ne correspondra pas aux Retweets ou aux Quote Tweets. |
| bounding_box:[west_long south_lat east_long north_lat] | Correspond à l’Emplacement exact ou à un polygone géographique « Place » entièrement contenu dans une boîte englobante. Les arguments sont placés entre crochets et séparés par des espaces. Coordonnées : degrés décimaux (±180 long, ±90 lat). La largeur et la hauteur doivent être < 25 mi. Exemple : bounding_box:[-105.301758 39.964069 -105.178505 40.09455]Remarque : ne correspond pas aux Retweets ni aux Quote Tweets. |
| profile_country | Renvoie les Publications pour lesquelles le code de pays géographique du profil de l’auteur correspond à un code ISO‑3166‑1‑alpha‑2 (deux lettres) donné. |
| profile_region | Effectue une correspondance exacte sur la valeur complète du champ « region » provenant de l’enrichissement géographique du profil de l’auteur. Utilisez des guillemets doubles pour les sous-chaînes contenant des espaces ou de la ponctuation. Exemple : profile_region:"New York" |
| profile_locality | Correspond au champ « locality » provenant de l’enrichissement géographique du profil de l’auteur, avec une correspondance exacte sur la chaîne complète. Utilisez des guillemets doubles pour les sous-chaînes contenant des espaces ou de la ponctuation. Exemple : profile_locality:"San Francisco" |
| profile_subregion | Fait correspondre le champ “subRegion” de l’enrichissement géographique du profil de l’auteur, y compris des comtés ou des zones métropolitaines spécifiques. Correspondance exacte sur la chaîne complète. Exemple : profile_subregion:"Santa Clara County" |
| has:geo | Fait correspondre les Publications qui comportent des données de géolocalisation spécifiques à la Publication provenant de X, y compris les données « geo » (latitude-longitude) ou les données de localisation « Place » avec un nom d’affichage et un polygone géographique. Remarque : avec l’API Search, il doit être combiné à des opérateurs autres que is: ou has:. |
| has:profile_geo | Renvoie les Publications comportant n’importe quelles métadonnées de géolocalisation de profil, quelle qu’en soit la valeur. Alias disponible : has:derived_user_geo.Remarque : avec l’API Search, doit être combiné avec des opérateurs autres que is: ou has:. |
| has:links | Fait correspondre les Publications comportant un lien ou un média référencé dans l’objet “text” de la charge utile, y compris les médias et les Tweets cités. Remarque : avec Search API, doit être combiné avec des opérateurs autres que is: ou has:. |
| is:retweet | Renvoie uniquement les retweets explicites. Peut être inversé pour exclure les retweets et ne renvoyer que du contenu original. Cet opérateur ne prend en compte que les vrais retweets et pas les Tweets cités. Remarque : avec l’API Search, il doit être combiné avec des opérateurs autres que is: ou has:. |
| is:reply | Renvoie uniquement les réponses explicites. Peut être utilisé sous forme négative pour exclure les réponses. PowerTrack fait correspondre les réponses aux Publications originales, les réponses dans les Publications citées et les réponses dans les Retweets. L’API Search ne fait correspondre que les réponses aux Publications originales. Exemple : @XDevelopers -is:reply |
| is:quote | Renvoie uniquement les Quote Tweets ou les Publications qui font référence à une autre Publication. Peut être utilisé en négation pour exclure les Quote Tweets. Exemple : @XDevelopers is:quote |
| is:verified | Retourne uniquement les Publications d’auteurs « vérifiés ». Peut être utilisé en négation pour exclure les Publications d’auteurs vérifiés. Exemple : @XDevelopers is:verified |
| has:mentions | Renvoie les Publications mentionnant un autre utilisateur X. Remarque : avec la Search API, doit être combiné à des opérateurs autres que is: ou has:. |
| has:hashtags | Correspond aux Publications contenant un hashtag. Remarque : avec l’API Search, doit être utilisé conjointement avec des opérateurs autres que is: ou has:. |
| has:media | Correspond aux Publications contenant une URL de média classée par X (par exemple, pic.x.com). Alias disponible : has:media_link.Remarque : avec l’API Search, doit être combiné avec des opérateurs autres que is: ou has:. |
| has:images | Correspond aux Publications contenant une URL de média (par exemple, pic.x.com). Remarque : avec la Search API, doit être combiné à des opérateurs autres que is: ou has:. |
| has:videos | Renvoie les Publications contenant des vidéos natives X mises en ligne sur X. Alias disponible : has:video_link.Cet opérateur n’inclut pas les vidéos provenant de YouTube, Periscope ou d’autres sites d’hébergement de vidéos. Remarque : avec Search API, il doit être combiné avec des opérateurs autres que is: ou has:. |
| has:symbols | Renvoie les Publications contenant un cashtag (par ex. $TWTR). Remarque : avec Search API, doit être combiné avec des opérateurs autres que is: ou has:. |
Opérateurs par produit
Règles et filtrage : Enterprise
| Opérateur | Produit | Description | Correspond à l’élément de payload |
|---|---|---|---|
| « 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 amhariquehu hongroispt portugaisar arabeis islandaisro roumainhy arménienin indonésienru russebn bengaliit italiensr serbebg bulgareja japonaissd sindhimy birmankn kannadasi singhalaiszh chinoiskm khmersk slovaquecs tchèqueko coréensl slovèneda danoislo laockb kurde soraninl néerlandaislv lettones espagnolen anglaislt lituaniensv suédoiset estonienml malayalamtl tagalogfi finnoisdv maldivienta tamoulfr françaismr marathite télougouka géorgienne népalaisth thaïde allemandno norvégienbo tibétainel grecor oriyatr turcgu goujaratipa pendjabiuk ukrainienht haïtienps pachtour ourdouiw hébreufa persanug ouïghourhi hindipl polonaisvi vietnamiency 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 |