Découvrez comment créer des requêtes de recherche à l’aide d’opérateurs
Les points de terminaison de recherche acceptent une requête unique via une requête GET et renvoient un ensemble de Publications historiques correspondant à cette requête. Les requêtes sont constituées d’opérateurs qui ciblent différents attributs de Publication.
Types d’opérateurs : autonomes et nécessitant une conjonction
Les opérateurs autonomes peuvent être utilisés seuls ou avec n’importe quel autre opérateur (y compris ceux qui nécessitent une conjonction).Par exemple, cette requête fonctionne parce que #hashtag est un opérateur autonome :
#xapiv2
Les opérateurs nécessitant une conjonction ne peuvent pas être utilisés seuls dans une requête ; ils ne peuvent l’être que si au moins un opérateur autonome est inclus. En effet, n’utiliser que ces opérateurs ferait correspondre un volume extrêmement élevé de Publications.Par exemple, les requêtes suivantes ne sont pas prises en charge car elles ne comportent que des opérateurs nécessitant une conjonction :
has:media
has:links OR is:retweet
Si nous ajoutons un opérateur isolé, comme l’expression "X data", la requête fonctionne correctement :
Ponctuation, signes diacritiques et sensibilité à la casse
Signes diacritiques : Les requêtes de recherche avec accents ou signes diacritiques renvoient des Publications avec et sans accents. Par exemple, Diacrítica correspond à la fois à Diacrítica et Diacritica.Sensibilité à la casse : Tous les opérateurs sont insensibles à la casse. La requête cat correspond à cat, CAT et Cat.
Le flux filtré se comporte différemmentLors de la création de règles de flux filtré, les mots-clés avec accents ne correspondent qu’aux Publications qui incluent également l’accent. Par exemple, Diacrítica correspond uniquement à Diacrítica, et pas à Diacritica.
Lors de l’utilisation de Search Posts, les opérateurs effectuent la correspondance sur le contenu du Quote Tweet, mais pas sur le contenu de la Publication d’origine citée.
Filtered stream se comporte différemment — il effectue la correspondance à la fois sur le Quote Tweet et sur le contenu de la Publication originale.
L’utilisation d’opérateurs génériques, comme un simple mot-clé ou un hashtag, n’est pas recommandée — cela renverra un volume massif de Publications et épuisera rapidement votre quota d’utilisation.
Conseils pour formuler des requêtes efficaces :
Commencez de manière spécifique, puis élargissez — Créez des requêtes ciblées qui renvoient des résultats pertinents
Utilisez plusieurs opérateurs — Combinez les opérateurs pour restreindre les résultats
Surveillez le nombre de caractères — Toute la chaîne de requête est comptabilisée dans la limite
Exemple de progression :
# Too broad - 200,000+ Posts per dayhappy# Mieux - ajoute un filtre de langue et des exclusions(happy OR happiness) lang:en -birthday -is:retweet# Even better - 59 characters, more specific(happy OR happiness) place_country:GB -birthday -is:retweet
Faire correspondre des Publications provenant d’agences météorologiques concernant l’ouragan Harvey :Requête :
has:geo (from:NWSNHC OR from:NHC_Atlantic OR from:NWSHouston OR from:NWSSanAntonio OR from:USGS_TexasRain OR from:USGS_TexasFlood OR from:JeffLindner1) -is:retweet
#nowplaying (happy OR exciting OR excited OR favorite OR fav OR amazing OR lovely OR incredible) (place_country:US OR place_country:MX OR place_country:CA) -horrible -worst -sucks -bad -disappointing
Sentiment négatif :
#nowplaying (horrible OR worst OR sucks OR bad OR disappointing) (place_country:US OR place_country:MX OR place_country:CA) -happy -exciting -excited -favorite -fav -amazing -lovely -incredible
Recherchez des Publications en japonais sur les animaux de compagnie (sauf les chats) avec des images en utilisant l’opérateur context: :Commencez par utiliser Recherche de Publications avec tweet.fields=context_annotations pour identifier les ID domain.entity :
Chats : domain 66, entity 852262932607926273
Animaux de compagnie : domain 65, entity 852262932607926273
