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 faire correspondre ou filtrer) 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
Conjonction de termes avec des espaces
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 deux présents dans le texte, dans n’importe quel ordre — avoir un espace entre les termes équivaut à une logique booléenne AND. Si vous incluez un AND explicite dans votre règle, il sera rejeté par l’endpoint des règles.
social media
Disjonction de termes avec OR en majuscules
De nombreuses situations nécessitent une logique booléenne OR. Cela est également simple à réaliser. Notez 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 d’exclure des 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 logiques peuvent être combinés en regroupant avec des parenthèses et étendus à des requêtes bien plus complexes.
(social OR data) (academic OR research) -personality -information -university
Ce n’est qu’un début — bien que les exemples ci-dessus reposent simplement sur une correspondance tokenisée des mots-clés, les produits Enterprise proposent également des opérateurs permettant d’effectuer différents types de correspondance sur le texte.
Correspondance exacte
"social media research"
Correspondance de sous-chaîne
contains:info
Correspondance par proximité
"social media research"~3
Par ailleurs, d’autres opérateurs vous permettent de filtrer selon des aspects uniques des données sociales, au-delà du seul texte.
L’utilisateur qui publie un Post
from:XDevelopers
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]
Tout combiner
Ces éléments peuvent être combinés avec des filtres textuels en utilisant les mêmes types de logiques 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 | Un 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é ordinaire. |
OR | social OR data | Pour appliquer un 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 » OR « data ») Notez que si vous combinez les fonctionnalités 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 garantir 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é ordinaire. |
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 présentée fait correspondre les activités contenant le mot‑clé « social », mais exclut celles qui contiennent le mot‑clé « data ». Les OR niés 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 ». |
Groupement | (social OR data) -XDevelopers -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 un espace (AND) ou des OR. Cependant, il est recommandé de ne pas regrouper les négations en appliquant le signe négatif - à l’ensemble du groupe. À la place, vous devez nier chaque opérateur individuellement, en les enchaînant avec des espaces (AND). Par exemple, au lieu d’utiliser -(iphone OR imac OR macbook), utilisez ce qui suit : -iphone -imac -macbook Le groupement est particulièrement important lorsqu’une règle unique combine des fonctionnalités 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 offres Premium d’opérateurs n’imposent aucune restriction quant au 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 reliés par la logique AND sont combinés en premier
- Ensuite, les opérateurs reliés par la logique OR sont appliqués
apple OR iphone ipad
sera évalué commeapple OR (iphone ipad)
ipad iphone OR android
sera évalué comme(iphone ipad) OR android
(apple OR iphone) ipad
iphone (ipad OR android)
Ponctuation, diacritiques et sensibilité à la casse
Diacr**í**tica
ou le hashtag #cumplea**ñ**os
fera correspondre « Diacrítica » ou « #cumpleaños », mais pas « Diacritica » ou « #cumpleanos » sans la tilde sur í ou la lettre eñe.
Les caractères accentués ou diacrités sont traités comme des caractères ordinaires et ne constituent pas des délimiteurs de mots. Par exemple, une règle cumpleaños ne ferait correspondre que des activités contenant le mot cumpleaños et ne ferait pas correspondre des 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
fera correspondre tous les éléments suivants : « cat », « CAT », « Cat ».
Comme indiqué 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, d’une longueur maximale de 255 caractères. Les balises sont incluses dans la règle au format JSON lors de sa création via l’API, comme indiqué sur notre page « Matching rules ».
Mise en forme des règles en JSON
{"value":"insert_rule_here"}
Règles avec des guillemets doubles
Si la règle contient des guillemets doubles ("
) associés à une correspondance exacte ou à d’autres opérateurs, ils doivent être échappés à l’aide d’une barre oblique inverse (backslash) pour 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 comportant des guillemets doubles
Pour inclure un 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 à l’expression “Toys “R” Us”, y compris les guillemets autour de “R”, la représentation en texte brut serait la suivante :
"Toys \"R\" Us"
En la convertissant au format JSON, vous devez utiliser la structure suivante :
{"value":"\"Toys \\\"R\\\" Us\""}
Règles avec des tags
Pour inclure un tag optionnel avec votre règle, comme décrit ci‑dessus, ajoutez simplement 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
Lors de l’ajout ou de la suppression de règles du stream 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 qui correspondent aux Tweets cités
Keywords
Phrases
Proximity
#hashtags
@mentions
$cashtags
url:
url_contains:
has:links
has:mentions
has:hashtags
has:media
has:symbols
is:quote
is:reply
Opérateurs Enterprise
Opérateur | Description |
---|---|
keyword | Correspond à un mot-clé dans le corps du texte ou l’URL d’un Post. Les mots-clés doivent commencer par un chiffre (0-9) ou tout caractère non-ponctuation. La correspondance de mots-clés est tokenisée, ce qui signifie que le mot-clé est comparé au texte tokenisé du corps du Post. Pour les chaînes avec ponctuation (par ex., “coca-cola”), utilisez une “correspondance de phrase exacte” entre guillemets. Exemple : (social OR pizza OR wildfire) -planet |
emoji | Correspond à un emoji dans le corps d’un Post, en utilisant une correspondance tokenisée basée sur la ponctuation, les symboles/emojis et les caractères séparateurs. Si un emoji a une variante, utilisez des guillemets pour des correspondances exactes. Exemple : (🍕 OR 💜 OR 🐢) -🤖 |
”correspondance de phrase exacte” | Correspond à une phrase exacte dans le corps d’un Post. La ponctuation est traitée comme un espace. Exemple : ("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth" |
# | Correspond à tout Post avec le hashtag spécifié. Il s’agit d’une correspondance exacte, ce qui signifie que #2016 correspondra aux Posts avec #2016 mais pas #2016election .Exemple : (#social OR #pizza OR #2016election) -#planet |
@ | Correspond à tout Post mentionnant le nom d’utilisateur spécifié. Exemple : (@XDevelopers OR @api OR @twittereng) -@jack |
”keyword1 keyword2”~N | Opérateur de proximité qui correspond à un Post où les mots-clés sont à N tokens l’un de l’autre. Les mots-clés dans l’ordre inverse ne peuvent pas être séparés de plus de 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 Posts avec la sous-chaîne spécifiée dans le corps, indépendamment de la tokenisation. Utilisez des guillemets doubles pour les sous-chaînes avec des espaces ou de la ponctuation. Exemple : (contains:social OR contains:"wikipedia.com") -contains:"buy now" |
from: | Correspond à tout Post d’un utilisateur spécifique par ID de compte numérique X ou nom d’utilisateur (excluant @ ).Exemple : (from:2244994945 OR from:api OR from:twittereng) -from:jack |
to: | Correspond à tout Post répondant à un utilisateur spécifique par ID de compte numérique X ou nom d’utilisateur (excluant @ ).Exemple : (to:2244994945 OR to:api OR to:twittereng) -to:jack |
url: | Effectue une correspondance tokenisée (mot-clé/phrase) sur les URL étendues d’un Post. Exemple : @XDevelopers url:"developer.x.com" |
url_title: | Effectue une correspondance de mot-clé/phrase sur les métadonnées de titre HTML de l’URL étendue. Disponible uniquement avec PowerTrack et Historical PowerTrack. |
url_description: | Effectue une correspondance de mot-clé/phrase sur les métadonnées de description de page étendue. Disponible uniquement avec PowerTrack et Historical PowerTrack. |
url_contains: | Correspond aux Posts avec des URL contenant la phrase ou le mot-clé spécifié. Entourez les termes de recherche avec ponctuation de guillemets. Exemple : (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit |
bio: | Correspond à un mot-clé ou une phrase dans la biographie utilisateur d’un Post. Il s’agit d’une correspondance tokenisée dans le champ ‘description’ de l’objet utilisateur. Exemple : (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
bio_name: | Correspond à un mot-clé dans le nom de biographie utilisateur d’un Post. Il s’agit d’une correspondance tokenisée dans le champ “name” d’un utilisateur de l’objet utilisateur. Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
bio_location: | Correspond aux Posts où la localisation de l’objet utilisateur 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 normales sur le corps du message. Cette localisation fait partie de l’objet utilisateur, et est la localisation ‘domicile’ du compte. Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
statuses_count: | Correspond aux Posts lorsque l’auteur a publié un nombre de statuses dans la plage donnée. Si un seul nombre est spécifié, tout nombre égal ou supérieur correspondra. Une plage peut être spécifiée pour correspondre à tout nombre dans la plage (par ex., statuses_count:1000..10000 ).Exemple : to:api statuses_count:10 Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
followers_count: | Correspond aux Posts lorsque l’auteur a un nombre d’abonnés dans la plage donnée. Si un seul nombre est spécifié, tout nombre égal ou supérieur correspondra. Une plage peut être spécifiée pour correspondre à tout nombre dans la plage (par ex., followers_count:1000..10000 ).Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
friends_count: | Correspond aux Posts lorsque l’auteur a un nombre d’amis (le nombre d’utilisateurs qu’ils suivent) dans la plage donnée. Si un seul nombre est spécifié, tout nombre égal ou supérieur correspondra. Une plage peut être spécifiée pour correspondre à tout nombre dans la plage (par ex., friends_count:1000..10000 ).Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
listed_count: | Correspond aux Posts lorsque l’auteur a été listé dans X un certain nombre de fois dans la plage donnée. Si un seul nombre est spécifié, tout nombre égal ou supérieur correspondra. Une plage peut être spécifiée pour correspondre à tout nombre dans la plage (par ex., listed_count:10..100 ).Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
$ | Correspond à tout Post qui contient l’entité ‘cashtag’ spécifiée. Exemple : ($TWTR OR $TSLA OR $BRK.A) -$F Remarque : L’opérateur cashtag s’appuie sur l’extraction d’entité ‘symbols’ de X pour correspondre aux cashtags, plutôt que de l’extraire du corps lui-même. |
retweets_of: | Correspond aux Posts qui sont des Retweets d’un utilisateur spécifié. Accepte à la fois les noms d’utilisateur et les ID de compte X numériques (PAS les ID de statut de Post). Exemple : (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack |
retweets_of_status_id: | Fournit uniquement les Retweets explicites du Post spécifié. Utilisez l’ID d’un Post original et non d’un Retweet. Exemple : retweets_of_status_id:1293593516040269825 Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
in_reply_to_status_id: | Fournit uniquement les réponses explicites au Post spécifié. Exemple : in_reply_to_status_id:1293593516040269825 Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
sample: | Retourne un échantillon aléatoire de Posts qui correspondent à une règle. Le pourcentage d’échantillon doit être un entier entre 1 et 100. L’opérateur réduit la portée à X%, puis la règle/filtre est appliquée à ce sous-ensemble échantillonné. Exemple : #happybirthday sample:5 "happy birthday"~5 sample:80 Remarque : Disponible uniquement avec PowerTrack et Historical PowerTrack. |
source: | Correspond à tout Post généré 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:MyTestAppName Remarque : L’opérateur source recherche sur l’attribut source du Post et ne peut pas être utilisé seul. |
lang: | Correspond aux Posts classifiés par X comme étant dans une langue particulière. Les Posts sont actuellement classifiés comme une seule langue, donc correspondre à plusieurs langues ne donne aucun résultat. Non recommandé d’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 | 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 |
Opérateur | Description |
---|---|
place | 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 doivent être placés entre guillemets. Exemple : (place:London OR place:"Great Britain") -place:USA place:fd70c22040963ac7 Remarque : Consultez l’endpoint API public GET geo/search pour savoir comment obtenir les ID de lieux X. Remarque : Ne correspondra pas aux Retweets ou Quote Tweets, car les lieux des Retweets sont attachés au Post original. |
place_country | Correspond aux Posts où le code pays associé à un lieu/emplacement étiqueté correspond au code de caractère ISO alpha-2 donné. Exemple : place_country:GB OR place_country:AU OR place_country:CA Remarque : Ne correspondra pas aux Retweets ou Quote Tweets, car les lieux des Retweets sont attachés au Post original. Codes ISO valides : ISO 3166-1 alpha-2. |
point_radius:[lon lat radius] | Correspond à l’emplacement exact (x,y) du Post ou à un polygone géographique “Place” dans le rayon défini. _ Rayon : < 25mi _ 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, délimité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 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 entre crochets, délimités par des espaces. Coordonnées : degrés décimaux (±180 long, ±90 lat). La largeur et la hauteur doivent être < 25mi. Exemple : bounding_box:[-105.301758 39.964069 -105.178505 40.09455] Remarque : Ne correspondra pas aux Retweets ou Quote Tweets. |
profile_country | Correspond aux Posts où le code pays géographique du profil de l’auteur correspond à un code à deux lettres ISO-3166-1-alpha-2 donné. |
profile_region | Correspond au champ “region” de l’enrichissement géographique du profil de l’auteur, une correspondance exacte de chaîne complète. 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” de l’enrichissement géographique du profil de l’auteur, une correspondance exacte de 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 | Correspond au champ “subRegion” de l’enrichissement géographique du profil de l’auteur, incluant des comtés spécifiques ou des zones métropolitaines. Une correspondance exacte de chaîne complète. Exemple : profile_subregion:"Santa Clara County" |
has:geo | Correspond aux Posts avec des données de géolocalisation spécifiques au Post provenant de X, incluant les données de latitude-longitude “geo” ou les données d’emplacement “Place” avec un nom d’affichage et un polygone géographique. Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
has:profile_geo | Correspond aux Posts avec des métadonnées Profile Geo, quelle que soit la valeur. Alias disponible : has:derived_user_geo .Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
has:links | Correspond aux Posts avec un lien ou un média référencé dans l’objet “text” de la charge utile, incluant les médias et Quote Tweets. Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
is:retweet | Renvoie uniquement les retweets explicites. Peut être nié pour exclure les retweets et renvoyer uniquement le contenu original. Cet opérateur recherche uniquement les vrais Retweets et non les Quoted Tweets. Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
is:reply | Renvoie uniquement les réponses explicites. Peut être nié pour exclure les réponses. PowerTrack correspond aux réponses aux Posts originaux, aux réponses dans les Posts cités, et aux réponses dans les Retweets. L’API Search correspond uniquement aux réponses aux Posts originaux. Exemple : @XDevelopers -is:reply |
is:quote | Renvoie uniquement les Quote Tweets ou Posts qui référencent un autre Post. Peut être nié pour exclure les Quote Tweets. Exemple : @XDevelopers is:quote |
is:verified | Renvoie uniquement les Posts d’auteurs “vérifiés”. Peut être nié pour exclure les Posts d’auteurs vérifiés. Exemple : @XDevelopers is:verified |
has:mentions | Correspond aux Posts mentionnant un autre utilisateur X. Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
has:hashtags | Correspond aux Posts contenant un hashtag. Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
has:media | Correspond aux Posts contenant une URL de média classifié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 non- is: ou has: . |
has:images | Correspond aux Posts contenant une URL de média (par exemple, pic.x.com). Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
has:videos | Correspond aux Posts contenant des vidéos X natives téléchargées sur X. Alias disponible : has:video_link .Cet opérateur ne correspond pas aux vidéos de YouTube, Periscope, ou d’autres sites d’hébergement vidéo. Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
has:symbols | Correspond aux Posts contenant un symbole cashtag (par exemple, $TWTR). Remarque : Avec l’API Search, doit être combiné avec des opérateurs non- is: ou has: . |
Opérateurs par produit
Règles et filtrage : Enterprise
Opérateur | Produit | Description | Correspond à l’élément de charge utile |
---|---|---|---|
”correspondance de phrase exacte” | PowerTrack Search | Correspond à une phrase exacte dans le corps d’un Post. Les composants qui peuvent se traduire en 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 correspondre aux hashtags réels) _ "$TWTR" correspondra au mot TWTR mais pas au cashtag $TWTR (utilisez l’opérateur cashtag sans guillemets pour correspondre aux cashtags réels)Remarque : dans 30 Day Search et Full Archive Search (Enterprise et Premium), la ponctuation n’est pas tokenisée et est plutôt traitée comme un espace blanc. | text |
@ | PowerTrack Search | Correspond à tout Post qui mentionne le nom d’utilisateur donné. La valeur peut être soit le nom d’utilisateur (excluant le caractère @ ) soit l’ID numérique de l’utilisateur (obtenu par exemple via l’endpoint GET users/lookup). | entities.user_mentions |
# | PowerTrack Search | Correspond à tout Post avec le hashtag donné. Cet opérateur effectue une correspondance exacte. Par exemple, la règle #1989 correspondra aux Posts contenant exactement le hashtag #1989 , mais pas à ceux avec le hashtag #TaylorSwift1989 .Remarque : cet opérateur s’appuie sur l’extraction d’entités de X pour correspondre aux hashtags, plutôt que d’extraire le hashtag du corps lui-même. Pour plus de détails sur les attributs JSON des entités, consultez X Entities. | entities.hashtags |
$ | PowerTrack Search | Correspond à tout Post qui contient le cashtag spécifié (où le caractère initial du token est $ ).Remarque : cet opérateur s’appuie sur l’extraction d’entités de X pour correspondre aux liens, plutôt que d’extraire le lien du corps 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: Correspond à un mot-clé (utilisant une correspondance tokenisée) ou une phrase dans la biographie utilisateur d’un Post. Utilisez des guillemets doubles pour correspondre à une phrase. En d’autres termes : _ bio:software engineer correspondra aux Posts avec le mot-clé engineer d’utilisateurs ayant le mot software dans leur biographie_ bio:"software engineer" correspondra à tout Post publié par des utilisateurs ayant la phrase software engineer dans leur biographie | user``.description |
bio_location: | PowerTrack | Alias disponible : user_bio_location: Correspond aux Posts où l’emplacement de l’objet utilisateur contient le mot-clé spécifié (utilisant une correspondance tokenisée) ou la phrase. Cet emplacement est une chaîne non normalisée, générée par l’utilisateur et de forme libre, et est différent de l’emplacement d’un Post (lorsqu’il est disponible). | user.location |
bio_name: | PowerTrack | Correspond aux Posts où le nom de l’objet utilisateur contient le mot-clé spécifié (utilisant une correspondance tokenisée) ou la phrase. | user.name |
bounding_box: | PowerTrack Search | Alias disponible : geo_bounding_box: Correspond à l’emplacement exact (long, lat) du Post (lorsqu’il est présent), et à un polygone géographique (où le lieu est entièrement contenu dans la région définie). _ west_long 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 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 est la latitude. _ La largeur et la hauteur de la boîte englobante doivent être inférieures à 25 miles _ 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. Remarque : les opérateurs correspondant au lieu (géolocalisation du Post) n’incluront que les correspondances des Posts originaux. Les Retweets ne contiennent aucune donnée de lieu. | place (Posts originaux uniquement) |
contains: | PowerTrack | Correspondance de sous-chaîne pour les Posts qui ont la sous-chaîne donnée dans le corps, indépendamment de la tokenisation. En d’autres termes, cela effectue une correspondance de sous-chaîne pure et ne considère pas les limites de mots. Utilisez des guillemets doubles pour correspondre aux sous-chaînes qui contiennent des espaces blancs ou de la ponctuation. | text |
<emoji> | PowerTrack Search | Correspond à un emoji dans le corps d’un Post. Il s’agit d’une correspondance tokenisée, donc votre emoji sera comparé au texte tokenisé du corps du Post. La tokenisation est basée sur la ponctuation, les symboles/emojis et les caractères de séparation du plan de base Unicode. Par exemple, un Post avec le texte “I like 🍕” serait divisé en tokens suivants : I, like, 🍕. Ces tokens seraient ensuite comparés à l’emoji utilisé dans votre règle. Remarque : si un emoji a une variante, vous devez utiliser des guillemets doubles pour l’ajouter à une règle. | text |
followers_count: | PowerTrack | Correspond aux Posts lorsque l’auteur a un nombre d’abonnés dans la plage donnée. _ Un seul nombre (par exemple followers_count:42 ) correspondra à tout nombre égal ou supérieur à la valeur spécifiée._ Une plage (par exemple followers_count:42..1337 ) correspondra à tout nombre dans la plage donnée. | user.followers_count |
friends_count: | PowerTrack | Alias disponible : following_count: Correspond aux Posts lorsque l’auteur a un nombre d’amis (le nombre d’utilisateurs qu’il suit) qui se situe dans la plage donnée. _ Un seul nombre (par exemple followers_count:42 ) correspondra à tout nombre égal ou supérieur à la valeur spécifiée._ Une plage (par exemple followers_count:42..1337 ) correspondra à tout nombre dans la plage donnée. | user.friends_count |
from: | PowerTrack Search | Correspond à tout Post d’un utilisateur spécifique. La valeur peut être soit le nom d’utilisateur (excluant le caractère @ ) soit l’ID numérique de l’utilisateur (obtenu par exemple via l’endpoint GET users/lookup). | user.id , user.id_str (si utilisation de l’ID utilisateur)user.screen_name (si utilisation du nom d’utilisateur) |
has:geo | PowerTrack Search | Correspond aux Posts qui ont des données de géolocalisation spécifiques au Post fournies par X. Cela peut être soit des coordonnées “geo” lat-long, soit un “location” sous la forme d’un Place X, 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 correspondant au lieu (géolocalisation du Post) n’incluront que les correspondances des Posts originaux. Les Retweets ne contiennent aucune donnée de lieu. | place (Posts originaux uniquement) |
has:hashtags | PowerTrack Search | Correspond aux Posts qui contiennent au moins un hashtag. Ne peut pas être utilisé comme opérateur autonome. | entities.hashtags |
has:images | PowerTrack Search | Correspond aux Posts qui contiennent au moins une URL d’image classifiée. Ne peut pas être utilisé comme opérateur autonome. | entities.media |
has:lang | PowerTrack | Correspond aux Posts qui ont été classifiés par X comme étant dans une langue particulière. Si un Post n’a pas été classifié, l’opérateur ne correspondra pas. Chaque Post n’est actuellement classifié que dans une seule langue, donc l’utilisation de l’opérateur AND avec plusieurs langues ne donnera 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 correspond aux Posts qui contiennent des liens dans le corps du Post. Ne peut pas être utilisé comme opérateur autonome. Remarque : cet opérateur s’appuie sur l’extraction d’entités de X pour faire correspondre les liens, plutôt que d’extraire le lien 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 Posts qui contiennent au moins une URL de média classifiée. Ne peut pas être utilisé comme opérateur autonome. | entities.media |
has:mentions | PowerTrack Search | Correspond aux Posts qui mentionnent un autre utilisateur X. Ne peut pas être utilisé comme opérateur autonome. | entities.user_mentions |
has:profile_geo | PowerTrack Search | Alias disponible : has:derived_user_geo Correspond aux Posts qui ont des métadonnées Profile Geo, quelle que soit la valeur réelle. Ne peut pas être utilisé comme opérateur autonome. | user.location |
has:symbols | PowerTrack Enterprise | Correspond aux Posts qui contiennent un symbole cashtag (par exemple $TWTR ).Ne peut pas être utilisé comme opérateur autonome. | entities.symbols |
has:videos | PowerTrack Search | Alias disponible : has:video_link Correspond aux Posts qui contiennent au moins une URL de média classifiée. Ne peut pas être utilisé comme opérateur autonome. | entities.media |
in_reply_to_status_id: | PowerTrack | Alias disponible : in_reply_to_tweet_id: Livrer uniquement les réponses explicites au Post spécifié. | id , id_str du Post cible |
is:quote | PowerTrack | Livrer les Quote Tweets explicites qui correspondent à une règle. Il peut également être nié ( -is:quote ) pour exclure les Quote Tweets qui correspondent à une règle de la livraison.Ne peut pas être utilisé comme opérateur autonome. | is_quote_status (si true ) |
is:reply | PowerTrack Search | Livrer uniquement les réponses qui correspondent à une règle. Il peut également être nié ( -is:reply ) pour exclure la livraison des réponses qui correspondent à la règle spécifiée.Avec PowerTrack, cet opérateur correspond à : _ Réponses à un Post original _ Réponses dans les Posts cités * Réponses dans les Retweets Lorsqu’il est utilisé avec l’API Search, cet opérateur correspond aux réponses à un Post original, mais exclut les réponses dans les Tweets cités et les réponses dans les Retweets. Vous pouvez utiliser cet opérateur en conjonction avec is:retweet et is:quote pour livrer uniquement les réponses aux Posts originaux.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 | Livrer uniquement les Retweets explicites qui correspondent à une règle. Il peut également être nié ( -is:retweet ) pour exclure les Retweets qui correspondent à une règle de la livraison et seul le contenu original est livré.Cet opérateur ne recherche que les vrais Retweets (c’est-à-dire les Retweets publiés en utilisant le bouton Retweet). Les Tweets cités et les Posts modifiés qui n’utilisent pas la fonctionnalité Retweet de X ne seront pas détectés par cet opérateur. Ne peut pas être utilisé comme opérateur autonome. | Éléments Retweet, par exemple retweeted_status |
is:verified | PowerTrack Search | Livrer uniquement les Posts dont l’auteur est vérifié par X. Il peut également être nié pour exclure les Posts dont l’auteur est vérifié. Ne peut pas être utilisé comme opérateur autonome. | user.verified |
keyword | PowerTrack Search | 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 est basée sur la ponctuation, les symboles/emojis et les caractères de séparation du plan de base Unicode. Par exemple, un Post avec le texte “I like coca-cola” serait divisé en jetons suivants : I , like , coca , cola . Ces jetons seraient ensuite comparés à la chaîne de mot-clé utilisée dans votre règle. Pour faire correspondre des chaînes contenant de la ponctuation (par exemple coca-cola), des symboles ou des caractères de séparation, vous devez utiliser un opérateur de correspondance de phrase exacte. | text |
lang: | PowerTrack Search | Correspond aux Posts qui ont été classés par X comme étant dans une langue particulière (si, et seulement si, le Post a été classé). Chaque Post sera classé avec une seule langue, donc l’utilisation de l’opérateur AND avec plusieurs langues ne donnera aucun résultat. Remarque : si aucune classification de langue ne peut être effectuée, le résultat fourni est und (pour indéfini).Cet opérateur ne correspondra qu’aux langues prises en charge. Fournir toute autre valeur (y compris und ) entraînera l’ignorance de l’opérateur (en d’autres termes, les Posts ne seront pas filtrés 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 Cinghalaiszh 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 Gujaratipa Pendjabiuk Ukrainienht Haïtienps Pachtour Ourdouiw Hébreufa Persanug Ouïghourhi Hindipl Polonaisvi Vietnamiency Gallois | lang quand la valeur n’est pas und |
listed_count: | PowerTrack | Alias disponible : user_in_lists_count: Correspond aux Posts lorsque l’auteur a été ajouté à des listes sur X un nombre de fois qui se situe dans la plage donnée. _ Un seul nombre (par exemple listed_count:42 ) correspondra à tout nombre égal ou supérieur à la valeur spécifiée._ Une plage (par exemple listed_count:42..1337 ) correspondra à tout nombre dans la plage donnée. | user.listed_count |
place_country: | PowerTrack Search | Correspond aux Posts où le code pays associé à un lieu/emplacement balisé correspond au code de caractère alpha-2 ISO donné. 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. | place (Posts originaux uniquement) |
place: | PowerTrack Search | Correspond aux Posts balisés avec l’emplacement spécifié ou l’ID de lieu X. Les noms de lieux composés de plusieurs mots doivent être entourés de guillemets (par exemple place:"San Francisco" )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. | place (Posts originaux uniquement) |
point_radius: | PowerTrack Search | 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. | place (Posts originaux uniquement) |
profile_bounding_box:[west_long south_lat east_long north_lat] | PowerTrack | Correspond à l’emplacement exact de l’utilisateur (long, lat) dans l’enrichissement Profile Geo où le lieu est entièrement contenu dans la région définie. _ west_long 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 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 est la latitude. _ La largeur et la hauteur de la boîte englobante doivent être inférieures à 25 miles _ 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. 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. | user.derived.locations.geo.coordinates |
profile_country: | PowerTrack Search | Correspondance exacte sur le code pays de l’enrichissement Profile Geo. Utilise un ensemble normalisé de codes pays à deux lettres, basé sur la spécification ISO-3166-1-alpha-2. Pour être concis, cet opérateur est fourni au lieu d’un opérateur pour le champ pays de l’objet adresse. 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. | 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 de chaîne complète. Il n’est pas nécessaire d’échapper les caractères avec une barre oblique inverse. Par exemple, si vous recherchez quelque chose avec une barre oblique, utilisez one/two .Utilisez des guillemets doubles pour rechercher des sous-chaînes qui contiennent des espaces ou de la ponctuation, par exemple profile_locality:"Lower East Side" . | user.derived.locations.locality |
profile_point_radius:[lon lat radius] | PowerTrack | Correspond à 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 miles. _ 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. 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. | user.derived.locations.geo |
profile_region: | PowerTrack Search | Correspondance exacte sur le champ Region de l’enrichissement Profile Geo. Il s’agit d’une correspondance exacte de chaîne 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 avec 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:"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 de chaîne 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 avec 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 | Communément appelé opérateur de proximité, ceci correspond à un Post où les mots-clés ne sont pas à plus de N jetons l’un de l’autre. Si les mots-clés sont dans l’ordre inverse, ils ne peuvent pas être à plus de N-2 jetons l’un de l’autre. Peut avoir 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: Délivre uniquement les Retweets explicites du Post original spécifié. | retweeted_status.id , retweeted_status.id_str |
retweets_of: | PowerTrack Search | Alias disponible : retweets_of_user: Correspond à tous les Posts qui sont des Retweets de l’utilisateur donné. La valeur peut être soit le nom d’utilisateur (excluant le caractère @ ) soit l’ID numérique de l’utilisateur (obtenu par exemple via l’endpoint GET users/lookup). | retweeted_status.id (si présent) |
sample: | PowerTrack | Retourne un échantillon aléatoire en pourcentage de Posts qui correspondent à une règle plutôt que l’ensemble complet de Posts. La valeur de pourcentage doit être représentée par un entier entre 1 et 100. Cet opérateur s’applique à la règle entière et nécessite que tous les termes OR soient groupés. Remarque : l’opérateur sample réduit d’abord la portée du firehose à X%, puis la règle/filtre est appliquée à ce sous-ensemble échantillonné. Si vous utilisez, par exemple, sample:10 , chaque Post a 10% de chance d’être dans 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 historiquement. | |
source: | PowerTrack | Correspond à tous les Posts générés par l’application source donnée. La valeur doit être soit le nom de l’application soit l’URL de l’application. Ne peut pas être utilisé comme opérateur autonome. | source |
statuses_count: | PowerTrack | Alias disponible : tweets_count: Correspond aux Posts lorsque l’auteur a publié un nombre de statuts qui se situe dans la plage donnée. • Un seul nombre (par exemple statuses_count:42 ) correspondra à tout nombre égal ou supérieur à la valeur spécifiée.• Une plage (par exemple statuses_count:42..1337 ) correspondra à tout nombre dans la plage donnée. | user``.statuses_count |
to: | PowerTrack Search | Correspond à tous les Posts qui sont en réponse à un utilisateur particulier. La valeur peut être soit le nom d’utilisateur (excluant le caractère @ ) soit l’ID numérique de l’utilisateur (obtenu par exemple via l’endpoint GET users/lookup). | text |
url: | PowerTrack Search | Effectue une correspondance tokenisée sur les URLs étendues d’un Post. Les jetons et phrases contenant de la ponctuation ou des caractères spéciaux doivent être entre guillemets doubles (par exemple url:"/developer" ).Bien que généralement non recommandé, l’opérateur peut également correspondre à un protocole spécifique, entre guillemets doubles (par exemple url:"https://developer.x.com" ). | entities.urls.expanded_url |
url_contains: | PowerTrack | Effectue une correspondance de mot-clé/phrase sur l’enrichissement de métadonnées de titre d’URL étendue (nouveau). | entities.urls.expanded_url |
url_description: | PowerTrack | Alias disponible : within_url_description: Effectue une correspondance de mot-clé/phrase sur l’enrichissement de métadonnées de description de page étendue (nouveau). | entities.urls.unwound.description |
url_title: | PowerTrack | Alias disponible : within_url_title: Effectue une correspondance de mot-clé/phrase sur l’enrichissement de métadonnées de titre d’URL étendue (nouveau). | entities.urls.title |