keyword | Standalone | Core | Corrisponde a una parola chiave nel corpo di un Post. Si tratta di una corrispondenza tokenizzata, il che significa che la stringa della parola chiave verrà confrontata con il testo tokenizzato del corpo del Post. La tokenizzazione divide le parole in base alla punteggiatura, ai simboli e ai caratteri separatori del piano base Unicode. Ad esempio, un Post con il testo “I like coca-cola” verrebbe diviso nei seguenti token: I, like, coca, cola. Questi token verrebbero quindi confrontati con la stringa della parola chiave utilizzata nella query. Per trovare corrispondenze con stringhe contenenti punteggiatura (ad esempio coca-cola), simboli o caratteri separatori, è necessario racchiudere la parola chiave tra virgolette doppie. Esempio: pepsi OR cola OR "coca cola" |
emoji | Standalone | Core | Corrisponde a un emoji nel corpo di un Post. Simile a una parola chiave, gli emoji sono una corrispondenza tokenizzata, il che significa che l’emoji verrà confrontato con il testo tokenizzato del corpo del Post. Nota che se un emoji ha una variante, è necessario racchiuderlo tra virgolette doppie per aggiungerlo a una query. Esempio: (😃 OR 😡) 😬 |
"exact phrase match" | Standalone | Core | Corrisponde alla frase esatta nel corpo di un Post. Esempio: ("X API" OR #v2) -"recent counts" |
# | Standalone | Core | Corrisponde a qualsiasi Post contenente un hashtag riconosciuto, se l’hashtag è un’entità riconosciuta in un Post. Questo operatore esegue una corrispondenza esatta, NON una corrispondenza tokenizzata, il che significa che la regola #thanku corrisponderà ai post con l’hashtag esatto #thanku, ma non a quelli con l’hashtag #thankunext. Esempio: #thankunext #fanart OR @arianagrande |
@ | Standalone | Core | Corrisponde a qualsiasi Post che menziona il nome utente specificato, se il nome utente è un’entità riconosciuta (incluso il carattere @). Esempio: (@XDevelopers OR @API) -@X |
$ | Standalone | Advanced | Corrisponde a qualsiasi Post che contiene il ‘cashtag’ specificato (dove il carattere iniziale del token è il carattere ‘'). Nota che l'operatore cashtag si basa sull'estrazione dell'entità 'symbols' di X per trovare corrispondenze con i cashtag, piuttosto che cercare di estrarre il cashtag dal corpo stesso. Esempio: `twtr OR @XDevelopers -$fb` |
from: | Standalone | Core | Corrisponde a qualsiasi Post da un utente specifico. Il valore può essere il nome utente (escludendo il carattere @) o l’ID numerico dell’utente. È possibile passare solo un singolo nome utente/ID per operatore from: . Esempio: from:XDevelopers OR from:API -from:X |
to: | Standalone | Core | Corrisponde a qualsiasi Post che è in risposta a un particolare utente. Il valore può essere il nome utente (escludendo il carattere @) o l’ID numerico dell’utente. È possibile passare solo un singolo nome utente/ID per operatore to: . Esempio: to:XDevelopers OR to:API -to:X |
url: | Standalone | Core | Esegue una corrispondenza tokenizzata su qualsiasi URL formattato correttamente di un Post. Questo operatore può trovare corrispondenze nel contenuto dei campi url o expanded_url . Ad esempio, un Post contenente “You should check out X Developer Labs: https://t.co/c0A36SWil4” (con l’URL breve che reindirizza a https://developer.x.com) corrisponderà a entrambe le seguenti regole: from:XDevelopers url:"https://developer.x.com" e from:XDevelopers url:"https://t.co" . Token e frasi contenenti punteggiatura o caratteri speciali dovrebbero essere racchiusi tra virgolette doppie. |
retweets_of: | Standalone | Core | Corrisponde ai Post che sono Retweet dell’utente specificato. Il valore può essere il nome utente (escludendo il carattere @) o l’ID numerico dell’utente. È possibile passare solo un singolo nome utente/ID per operatore retweets_of: . Esempio: retweets_of:XDevelopers OR retweets_of:API |
context: | Standalone | Core | Corrisponde ai Post con una specifica coppia domain id/entity id. È possibile passare solo un singolo dominio/entità per operatore context: . Esempio: context:domain_id.entity_id . È possibile combinare più domini/entità utilizzando l’operatore OR: (context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | Standalone | Core | Corrisponde ai Post con un valore stringa di entità specifico. È possibile passare solo un singolo operatore entity: . Esempio: entity:"string declaration of entity/place" . Si prega di notare che questo è disponibile solo con la ricerca recente. |
conversation_id: | Standalone | Core | Corrisponde ai Post che condividono un ID conversazione comune. Un ID conversazione è impostato sull’ID del Post di un Post che ha iniziato una conversazione. Quando vengono pubblicate le risposte a un Post, anche le risposte alle risposte, il conversation_id viene aggiunto al suo payload JSON. È possibile passare solo un singolo ID conversazione per operatore conversation_id: . Esempio: conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | Standalone | Advanced | Corrisponde ai Post pubblicati da utenti che sono membri di una List specificata. Ad esempio, se @XDevelopers e @API fossero membri della List 123, e includessi list:123 nella tua query, la tua risposta conterrà solo Post che sono stati pubblicati da quegli account. È possibile trovare gli ID delle List utilizzando l’endpoint di ricerca List. Esempio: list:123 |
place: | Standalone | Advanced | Corrisponde ai Post taggati con la posizione specificata o l’ID luogo di X. I nomi di luoghi composti da più parole (“New York City”, “Palo Alto”) dovrebbero essere racchiusi tra virgolette. È possibile passare solo un singolo luogo per operatore place: . Nota: Vedere l’endpoint GET geo/search Standard v1.1 per come ottenere gli ID luogo di X. Esempio: place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | Standalone | Advanced | Corrisponde ai Post dove il codice paese associato a un luogo/posizione taggato corrisponde al codice carattere ISO alpha-2 specificato. È possibile trovare un elenco di codici ISO validi su Wikipedia. È possibile passare solo un singolo codice ISO per operatore place_country: . Esempio: place_country:US OR place_country:MX OR place_country:CA |
point_radius: | Standalone | Advanced | Corrisponde all’oggetto place.geo.coordinates del Post quando presente, e in X, a un poligono geo del luogo, dove il poligono del luogo è completamente contenuto all’interno della regione definita. point_radius:[longitude latitude radius] . Le unità di raggio supportate sono miglia (mi) e chilometri (km). Il raggio deve essere inferiore a 25mi. La longitudine è nell’intervallo di ±180. La latitudine è nell’intervallo di ±90. Tutte le coordinate sono in gradi decimali. Gli argomenti della regola sono contenuti tra parentesi quadre, delimitati da spazi. Esempio: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | Standalone | Advanced | Corrisponde all’oggetto place.geo.coordinates del Post quando presente, e in X, a un poligono geo del luogo, dove il poligono del luogo è completamente contenuto all’interno della regione definita. bounding_box:[west_long south_lat east_long north_lat] . La larghezza e l’altezza del riquadro di delimitazione devono essere inferiori a 25mi. La longitudine è nell’intervallo di ±180. La latitudine è nell’intervallo di ±90. Tutte le coordinate sono in gradi decimali. Gli argomenti della regola sono contenuti tra parentesi quadre, delimitati da spazi. Esempio: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | Conjunction required | Core | Corrisponde ai Retweet che corrispondono al resto della regola specificata. Questo operatore cerca solo veri Retweet (ad esempio, quelli generati utilizzando il pulsante Retweet). I Quote Tweet non verranno trovati da questo operatore. Esempio: data @XDevelopers -is:retweet |
is:reply | Conjunction required | Core | Restituisce solo risposte esplicite che corrispondono a una regola. Può anche essere negato per escludere dalla consegna le risposte che corrispondono a una query. Nota: Questo operatore è disponibile anche con l’endpoint filtered stream. Quando utilizzato con filtered stream, questo operatore trova corrispondenze nelle risposte a un Post originale, nelle risposte nei Post quotati e nelle risposte nei Retweet. Esempio: from:XDevelopers is:reply |
is:quote | Conjunction required | Core | Restituisce tutti i Quote Tweet, noti anche come Post con commenti. Esempio: "sentiment analysis" is:quote |
is:verified | Congiunzione richiesta | Core | Restituisce solo Post i cui autori sono verificati da X. Esempio: #nowplaying is:verified |
-is :nullcast | Congiunzione richiesta | Advanced | Rimuove Post creati esclusivamente per promozione su ads.x.com che hanno "source":"Twitter for Advertisers (legacy)" o "source":"Twitter for Advertisers" . Questo operatore deve essere negato. Per maggiori informazioni sui Post Nullcast, consulta la nostra pagina sulla disponibilità dei Post. Esempio: "mobile games" -is:nullcast |
has:hashtags | Congiunzione richiesta | Core | Corrisponde ai Post che contengono almeno un hashtag. Esempio: from:XDevelopers -has:hashtags |
has:cashtags | Congiunzione richiesta | Advanced | Corrisponde ai Post che contengono un simbolo cashtag (con un carattere ‘' iniziale. Ad esempio, `tag). Esempio: #stonks has:cashtags` |
has:links | Congiunzione richiesta | Core | Questo operatore corrisponde ai Post che contengono link e media nel corpo del Post. Esempio: from:XDevelopers announcement has:links |
has:mentions | Congiunzione richiesta | Core | Corrisponde ai Post che menzionano un altro utente X. Esempio: #nowplaying has:mentions |
has:media | Congiunzione richiesta | Core | Corrisponde ai Post che contengono un oggetto media, come una foto, GIF o video, come determinato da X. Questo non corrisponderà ai media creati con Periscope, o ai Post con link ad altri siti di hosting media. Esempio: (kittens OR puppies) has:media |
has:images | Congiunzione richiesta | Core | Corrisponde ai Post che contengono un URL riconosciuto verso un’immagine. Esempio: #meme has:images |
has:videos | Congiunzione richiesta | Core | Corrisponde ai Post che contengono video nativi X, caricati direttamente su X. Questo non corrisponderà ai video creati con Periscope, o ai Post con link ad altri siti di hosting video. Esempio: #icebucketchallenge has:videos |
has:geo | Congiunzione richiesta | Advanced | Corrisponde ai Post che hanno dati di geolocalizzazione specifici del Post forniti dall’utente X. Questo può essere una posizione sotto forma di luogo X, con il nome visualizzato corrispondente, poligono geografico e altri campi, o in rari casi, una coordinata geografica lat-long. Nota: Gli operatori che corrispondono al luogo (geo del Post) includeranno solo corrispondenze dai post originali. I Retweet non contengono dati di luogo. Esempio: recommend #paris has:geo -bakery |
lang: | Congiunzione richiesta | Core | Corrisponde ai Post che sono stati classificati da X come appartenenti a una particolare lingua (se, e solo se, il Post è stato classificato). È importante notare che ogni Post è attualmente classificato solo come appartenente a una lingua, quindi utilizzare AND insieme a più lingue non produrrà risultati. Puoi passare solo un singolo identificatore di lingua BCP 47 per operatore lang: . Nota: se non può essere effettuata alcuna classificazione linguistica, il risultato fornito è ‘und’ (per indefinito). Esempio: recommend #paris lang:en |