Regole e filtri: Enterprise

​

Introduzione alle regole e alle query Enterprise

I prodotti che utilizzano operatori Enterprise forniscono dati social in base alle regole di filtro che imposti. Le regole sono composte da una o più “clausole”, dove una clausola è una parola chiave, una frase esatta o uno dei numerosi operatori Enterprise. Prima di iniziare a creare regole con operatori Enterprise, assicurati di esaminare la sintassi descritta di seguito, di consultare l’elenco degli operatori disponibili e di comprendere le limitazioni relative alla creazione delle regole. Assicurati inoltre di comprendere le sfumature di come le regole vengono valutate logicamente, nella sezione “Order of operations”.

Più clausole possono essere combinate con logica “and” e “or”.

Nota: la logica “and” è indicata da uno spazio tra le clausole, mentre la logica “or” è indicata con OR in maiuscolo.

Ogni regola può avere una lunghezza massima di 2.048 caratteri, senza limiti sul numero di clausole positive (elementi che vuoi trovare o su cui vuoi filtrare) e clausole negative (elementi che vuoi escludere e non trovare).  

​

Creare regole e query 

Corrispondenza per parola chiave

Le corrispondenze per parola chiave sono simili alle query in un’interfaccia di ricerca. Ad esempio, la seguente regola con operatore Enterprise corrisponderebbe ad attività con il termine “social” nel corpo del testo.

social

AND tra termini con spazio

Aggiungere un’altra parola chiave equivale ad aggiungere un altro requisito per trovare corrispondenze. Ad esempio, questa regola corrisponderebbe solo alle attività in cui siano presenti sia “social” sia “media” nel testo, in qualsiasi ordine – la presenza di uno spazio tra i termini equivale alla logica booleana AND. Se includi un AND esplicito nella tua regola, verrà rifiutato dall’endpoint delle regole.

social media

OR tra termini con OR maiuscolo

Molte situazioni richiedono la logica booleana OR. Questo si ottiene facilmente. Si noti che l’operatore OR deve essere in maiuscolo e un ‘or’ in minuscolo sarà trattato come una normale parola chiave.

social OR data

Negazione dei termini

Altri scenari possono richiedere di escludere risultati con determinate parole chiave (logica booleana NOT). Ad esempio, attività con ‘happy’, ma escludendo quelle con ‘birthday’ nel testo.

social -personality

Raggruppamento con parentesi

Questi tipi di logica possono essere combinati usando il raggruppamento con parentesi ed estesi a query molto più complesse.

(social OR data) (academic OR research) -personality -information -university

Questo è solo l’inizio: mentre gli esempi sopra si basano semplicemente su corrispondenze tokenizzate per parole chiave, i prodotti Enterprise offrono anche operatori per eseguire diversi tipi di corrispondenza sul testo.

Corrispondenza esatta

"social media research"

Corrispondenza di sottostringa

contains:info

Corrispondenza per prossimità

"social media research"~3

Inoltre, altri operatori consentono di filtrare aspetti unici dei dati social, oltre al solo testo. 

Utente che pubblica un Post

from:XDevelopers

Tweet con geotag nel raggio di 10 miglia da Pearl St. a Boulder, CO, Stati Uniti

point_radius:[-105.27346517 40.01924738 10.0mi]

Mettere tutto insieme

Questi possono essere combinati con filtri testuali usando gli stessi tipi di logica descritti sopra.

(social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university

​

Sintassi booleana

Gli esempi nella sezione precedente utilizzavano vari tipi di logica booleana e di raggruppamento. Consulta la tabella seguente per ulteriori dettagli su sintassi e requisiti di ciascuna.

Tipo di logica	Sintassi dell’operatore	Descrizione
AND	social data	Uno spazio tra due operatori produce una logica AND tra di essi Corrisponde ad attività che contengono entrambe le parole chiave (“social”, “data”). Non usare AND esplicitamente nella tua regola. Usa solo lo spazio. Un AND esplicito verrà trattato come una normale parola chiave.
OR	social OR data	Per mettere in OR due operatori, inserisci un OR tutto maiuscolo, delimitato da spazi tra di essi Corrisponde ad attività con UNA delle due parole chiave (“social” OR “data”) Nota che se combini funzionalità OR e AND in un’unica regola, dovresti comprendere l’ordine delle operazioni descritto nella nostra sezione “Order of operations” e valutare di raggruppare insieme gli operatori non negati usando le parentesi, come descritto sotto, per garantire che la regola si comporti come previsto. Devi usare “OR” in maiuscolo nella tua regola. “or” in minuscolo verrà trattato come una normale parola chiave.
NOT	social data -apple -android -phone	Inserisci un carattere - immediatamente davanti all’operatore o al gruppo di operatori. La regola di esempio mostrata corrisponde ad attività contenenti la parola chiave “social”, ma esclude quelle che contengono la parola chiave “data”. Le OR negate non sono consentite quando la regola richiederebbe “tutto nel firehose tranne la negazione”. Ad esempio, apple OR -ipad non è valida perché corrisponderebbe a tutte le attività tranne quelle che menzionano “ipad”.
Raggruppamento	(social OR data) -XDevelopers -api	Le parentesi attorno a più operatori creano un “gruppo” funzionale. I gruppi possono essere collegati a clausole allo stesso modo di una singola clausola tramite spazio (AND) o OR. Tuttavia, è una buona pratica evitare di raggruppare negazioni applicando il segno meno di negazione all’intero gruppo. Invece, è preferibile negare ciascun operatore singolarmente, concatenandoli tramite spazio (AND).  Ad esempio, invece di usare -(iphone OR imac OR macbook), usa quanto segue: -iphone -imac -macbook Il raggruppamento è particolarmente importante quando una singola regola combina funzionalità AND e OR, a causa dell’ordine delle operazioni usato per valutare la regola. Vedi sotto per maggiori dettagli.

Nota bene: gli operatori possono essere positivi o negativi.

Operatori positivi definiscono ciò che vuoi includere nei risultati. Ad es. l’operatore has:hashtags indica “Voglio attività contenenti hashtag.”

Operatori negativi definiscono ciò che vuoi escludere dai risultati e vengono creati utilizzando la logica booleana NOT descritta sopra. Ad esempio, -has:hashtags indica “Escludi qualsiasi attività contenente hashtag, anche se altrimenti corrispondono alla mia regola.”

I prodotti operator Premium non hanno restrizioni sul numero di clausole positive e negative, nel rispetto di una lunghezza massima di 2.048 caratteri.  

​

Ordine delle operazioni

Quando si combinano le funzionalità AND e OR in un’unica regola, il seguente ordine delle operazioni stabilisce come verrà valutata la regola.

1. Gli operatori collegati con logica AND vengono combinati per primi
2. Poi si applicano gli operatori collegati con logica OR

Esempio:

• apple OR iphone ipad verrebbe valutato come apple OR (iphone ipad)
• ipad iphone OR android verrebbe valutato come (iphone ipad) OR android

Per eliminare ambiguità e garantire che le regole vengano valutate come previsto, raggruppa i termini tra parentesi quando opportuno. Ad esempio:

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

​

Punteggiatura, diacritici e distinzione tra maiuscole e minuscole

Se specifichi una regola per parola chiave o hashtag con accenti o diacritici per gli operatori Enterprise, verrà eseguito il match sul testo del Post rispettando i diacritici (hashtag o parole chiave). Una regola con la parola chiave Diacr**í**tica o con l’hashtag #cumplea**ñ**os farà match con “Diacrítica” o “#cumpleaños”, ma non con “Diacritica” o “#cumpleanos” prive della tilde í o della eñe.

I caratteri con accenti o diacritici sono trattati come caratteri normali e non come delimitatori di parola. Ad esempio, una regola cumpleaños farebbe match solo con attività che contengono la parola cumpleaños e non con attività che contengono cumplea, cumplean o os.

Tutti gli operatori sono valutati in modo case-insensitive. Ad esempio, la regola Cat farà match con tutti i seguenti: “cat”, “CAT”, “Cat”.

​

Tag delle regole PowerTrack

Come descritto nella pagina “Matching rules”, ogni regola può essere creata con un tag. Questi tag non influiscono sul filtraggio, ma possono essere usati per creare raggruppamenti logici di regole all’interno della tua App. Ogni regola può avere un solo tag, con un massimo di 255 caratteri. I tag vengono inclusi nella regola in formato JSON al momento della creazione tramite l’API, come descritto nella pagina “Matching rules”.

​

Definire le regole in formato JSON

Per aggiungere o eliminare una regola da uno stream tramite l’API, le regole devono utilizzare il formato JSON. In sostanza, è necessario inserire ciascuna regola nella seguente struttura:

{"value":"insert_rule_here"}

Regole con virgolette doppie

Se la regola contiene caratteri di virgolette doppie (") associati a corrispondenza esatta o ad altri operatori, devono essere preceduti da un backslash (escape) per distinguerli dalla struttura del formato JSON.

"social data" @XDevelopers

La regola in formato JSON sarà:

{"value":"\"social data\" @XDevelopers"}

Regole con virgolette doppie come letterali di stringa

Per includere un carattere di virgolette doppie come letterale di stringa all’interno di una corrispondenza esatta, è necessario applicare un doppio escape. Ad esempio, per una regola che corrisponda esattamente alla frase “Toys “R” Us”, includendo le virgolette doppie attorno a “R”, la rappresentazione in testo semplice sarà la seguente:

"Toys \"R\" Us"

Convertendo questo nel formato JSON, utilizzare la seguente struttura:

{"value":"\"Toys \\\"R\\\" Us\""}

Regole con tag

Per includere un tag facoltativo nella regola, come descritto sopra, aggiungere semplicemente un campo tag insieme al valore della regola.

{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}

Formattazione per le richieste API

Quando si aggiungono o si eliminano regole dallo stream tramite l’API, più regole in formato JSON devono essere separate da virgole e racchiuse in un array JSON “rules”, come mostrato di seguito:

{"rules":[{"value":"from:XDevelopers"},{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

​

Operatori che corrispondono ai Quote Tweet

Quando si utilizzano la PowerTrack API e la Historical PowerTrack API, gli operatori riportati di seguito corrisponderanno sia al contenuto del Post originale citato sia al nuovo Quote Tweet.

Tuttavia, se si utilizza la Search API, questi operatori corrisponderanno solo al contenuto del Quote Tweet e non a quello del Post originale citato.

• Keywords
• Phrases
• Proximity
• #hashtags
• @mentions
• $cashtags
• url:
• url_contains:
• has:links
• has:mentions
• has:hashtags
• has:media
• has:symbols
• is:quote
• is:reply

​

Operatori Enterprise

Di seguito sono elencati gli operatori disponibili con PowerTrack e Historical PowerTrack. Un sottoinsieme è disponibile con le API di ricerca 30-Day e Full-Archive. Consulta questa tabella per un elenco degli operatori disponibili, suddiviso per prodotto. 

Operatore	Descrizione
keyword	Trova una parola chiave nel corpo del testo o nell’URL di un Post. Le parole chiave devono iniziare con una cifra (0-9) o qualsiasi carattere non di punteggiatura. La corrispondenza delle parole chiave è tokenizzata, il che significa che la parola chiave viene confrontata con il testo tokenizzato del corpo del Post. Per stringhe con punteggiatura (ad esempio, “coca-cola”), utilizzare una “corrispondenza esatta di frase” tra virgolette. Esempio: (social OR pizza OR wildfire) -planet
emoji	Trova un emoji nel corpo di un Post, utilizzando la corrispondenza tokenizzata basata su punteggiatura, simboli/emoji e caratteri separatori. Se un emoji ha una variante, utilizzare le virgolette per corrispondenze esatte. Esempio: (🍕 OR 💜 OR 🐢) -🤖
”exact phrase match”	Trova una frase esatta nel corpo di un Post. La punteggiatura viene trattata come spazio bianco. Esempio: ("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth"
#	Trova qualsiasi Post con l’hashtag specificato. Questa è una corrispondenza esatta, il che significa che #2016 troverà post con #2016 ma non #2016election. Esempio: (#social OR #pizza OR #2016election) -#planet
@	Trova qualsiasi Post che menziona il nome utente specificato. Esempio: (@XDevelopers OR @api OR @twittereng) -@jack
”keyword1 keyword2”~N	Operatore di prossimità che trova un Post dove le parole chiave sono entro N token l’una dall’altra. Le parole chiave in ordine inverso possono essere distanti al massimo N-2 token. N non può essere maggiore di 6. Esempio: "social media"~5 OR "API"~3
contains:	Corrispondenza di sottostringa per Post con la sottostringa specificata nel corpo, indipendentemente dalla tokenizzazione. Utilizzare virgolette doppie per sottostringhe con spazi bianchi o punteggiatura. Esempio: (contains:social OR contains:"wikipedia.com") -contains:"buy now"
from:	Trova qualsiasi Post da un utente specifico tramite ID Account numerico X o nome utente (escludendo @). Esempio: (from:2244994945 OR from:api OR from:twittereng) -from:jack
to:	Trova qualsiasi Post che risponde a un utente specifico tramite ID Account numerico X o nome utente (escludendo @). Esempio: (to:2244994945 OR to:api OR to:twittereng) -to:jack
url:	Esegue una corrispondenza tokenizzata (parola chiave/frase) sugli URL espansi di un post. Esempio: @XDevelopers url:"developer.x.com"
url_title:	Esegue una corrispondenza di parola chiave/frase sui metadata del titolo HTML dell’URL espanso. Disponibile solo con PowerTrack e Historical PowerTrack.
url_description:	Esegue una corrispondenza di parola chiave/frase sui metadata della descrizione della pagina espansa. Disponibile solo con PowerTrack e Historical PowerTrack.
url_contains:	Trova Post con URL che contengono la frase o parola chiave specificata. Racchiudere i termini di ricerca con punteggiatura tra virgolette. Esempio: (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit
bio:	Trova una parola chiave o frase nella biografia utente di un Post. Questa è una corrispondenza tokenizzata nel campo ‘description’ dell’oggetto utente. Esempio: (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
bio_name:	Trova una parola chiave nel nome della biografia utente di un Post. Questa è una corrispondenza tokenizzata nel campo “name” di un utente nell’oggetto utente. Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
bio_location:	Trova Post dove la posizione dell’oggetto utente contiene la parola chiave o frase specificata. Questo operatore esegue una corrispondenza tokenizzata, simile alle normali regole delle parole chiave sul corpo del messaggio. Questa posizione fa parte dell’oggetto utente, ed è la posizione ‘principale’ dell’account. Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
statuses_count:	Trova Post quando l’autore ha pubblicato un numero di statuses nell’intervallo specificato. Se viene specificato un singolo numero, qualsiasi numero uguale o superiore corrisponderà. È possibile specificare un intervallo per trovare qualsiasi numero nell’intervallo (ad esempio, statuses_count:1000..10000). Esempio: to:api statuses_count:10 Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
followers_count:	Trova Post quando l’autore ha un numero di follower nell’intervallo specificato. Se viene specificato un singolo numero, qualsiasi numero uguale o superiore corrisponderà. È possibile specificare un intervallo per trovare qualsiasi numero nell’intervallo (ad esempio, followers_count:1000..10000). Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
friends_count:	Trova Post quando l’autore ha un numero di utenti seguiti nell’intervallo specificato. Se viene specificato un singolo numero, qualsiasi numero uguale o superiore corrisponderà. È possibile specificare un intervallo per trovare qualsiasi numero nell’intervallo (ad esempio, friends_count:1000..10000). Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
listed_count:	Trova Post quando l’autore è stato inserito in liste su X un certo numero di volte nell’intervallo specificato. Se viene specificato un singolo numero, qualsiasi numero uguale o superiore corrisponderà. È possibile specificare un intervallo per trovare qualsiasi numero nell’intervallo (ad esempio, listed_count:10..100). Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
$	Trova qualsiasi Post che contiene l’entità ‘cashtag’ specificata. Esempio: ($TWTR OR $TSLA OR $BRK.A) -$F Nota: L’operatore cashtag si basa sull’estrazione dell’entità ‘symbols’ di X per trovare i cashtag, piuttosto che estrarli dal corpo stesso.
retweets_of:	Trova Post che sono Retweet di un utente specificato. Accetta sia nomi utente che ID Account numerici X (NON ID di stato Post). Esempio: (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack
retweets_of_status_id:	Restituisce solo Retweet espliciti del Post specificato. Utilizzare l’ID di un Post originale e non di un Retweet. Esempio: retweets_of_status_id:1293593516040269825 Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
in_reply_to_status_id:	Restituisce solo risposte esplicite al Post specificato. Esempio: in_reply_to_status_id:1293593516040269825 Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
sample:	Restituisce un campione casuale di Post che corrispondono a una regola. La percentuale del campione deve essere un numero intero tra 1 e 100. L’operatore riduce l’ambito a X%, quindi la regola/filtro viene applicata a quel sottoinsieme campionato. Esempio: #happybirthday sample:5 "happy birthday"~5 sample:80 Nota: Disponibile solo con PowerTrack e Historical PowerTrack.
source:	Trova qualsiasi Post generato dall’applicazione sorgente specificata. Il valore può essere il nome dell’applicazione o l’URL dell’applicazione. Esempio: #happybirthday source:"X for iPhone" "This is a test X from my TestingApp" source:MyTestAppName Nota: L’operatore source cerca sull’attributo sorgente del Post e non può essere utilizzato da solo.
lang:	Trova Post classificati da X come appartenenti a una lingua particolare. I Post sono attualmente classificati come appartenenti a una sola lingua, quindi la corrispondenza di più lingue non produce risultati. Non raccomandato per l’uso da solo.

L’elenco seguente indica le lingue attualmente supportate e il relativo identificatore linguistico BCP 47:

Amarico: am	Tedesco: de	Malayalam: ml	Slovacco: sk
Arabo: ar	Greco: el	Maldiviano: dv	Sloveno: sl
Armeno: hy	Gujarati: gu	Marathi: mr	Curdo sorani: ckb
Basco: eu	Creolo haitiano: ht	Nepalese: ne	Spagnolo: es
Bengalese: bn	Ebraico: iw	Norvegese: no	Svedese: sv
Bosniaco: bs	Hindi: hi	Oriya: or	Tagalog: tl
Bulgaro: bg	Hindi latinizzato: hi-Latn	Punjabi: pa	Tamil: ta
Birmano: my	Ungherese: hu	Pashto: ps	Telugu: te
Croato: hr	Islandese: is	Persiano: fa	Thai: th
Catalano: ca	Indonesiano: in	Polacco: pl	Tibetano: bo
Ceco: cs	Italiano: it	Portoghese: pt	Cinese tradizionale: zh-TW
Danese: da	Giapponese: ja	Rumeno: ro	Turco: tr
Olandese: nl	Kannada: kn	Russo: ru	Ucraino: uk
Inglese: en	Khmer: km	Serbo: sr	Urdu: ur
Estone: et	Coreano: ko	Cinese semplificato: zh-CN	Uiguro: ug
Finlandese: fi	Lao: lo	Sindhi: sd	Vietnamita: vi
Francese: fr	Lettone: lv	Singalese: si	Gallese: cy
Georgiano: ka	Lituano: lt

Esempio:

(@XDevelopers OR to:XDevelopers) lang:es

Nota: L’operatore di lingua effettua il match sulla lingua specifica del Post determinata da X e impostata come attributo lang del Post. Vedi QUI per ulteriori informazioni sugli attributi JSON delle entità di X. Se non è possibile classificare la lingua di un Post, il lang del Post verrà impostato su “und” (non definito).

Operatore	Descrizione
place	Trova corrispondenze con Post taggati con la posizione specificata o l’ID luogo di X. I nomi di luoghi composti da più parole devono essere racchiusi tra virgolette. Esempio: (place:London OR place:"Great Britain") -place:USA place:fd70c22040963ac7 Nota: Consulta l’endpoint API pubblico GET geo/search per informazioni su come ottenere gli ID luogo di X. Nota: Non trova corrispondenze con Retweet o Quote Tweet, poiché i luoghi dei Retweet sono associati al Post originale.
place_country	Trova corrispondenze con Post dove il codice paese associato a un luogo/posizione taggato corrisponde al codice carattere ISO alpha-2 fornito. Esempio: place_country:GB OR place_country:AU OR place_country:CA Nota: Non trova corrispondenze con Retweet o Quote Tweet, poiché i luoghi dei Retweet sono associati al Post originale. Codici ISO validi: ISO 3166-1 alpha-2.
point_radius:[lon lat radius]	Trova corrispondenze con la Posizione Esatta (x,y) del Post o un poligono geografico “Place” all’interno del raggio definito. _ Raggio: < 25mi _ Unità supportate: mi, km _ Longitudine: ±180 _ Latitudine: ±90 Le coordinate sono in gradi decimali. Gli argomenti sono racchiusi tra parentesi quadre, delimitati da spazi. Esempio: point_radius:[-105.27346517 40.01924738 0.5mi] Esempio: point_radius:[2.355128 48.861118 16km] Nota: Non trova corrispondenze con Retweet o Quote Tweet.
bounding_box:[west_long south_lat east_long north_lat]	Trova corrispondenze con Posizione Esatta o un poligono geografico “Place” completamente contenuto in un riquadro di delimitazione. Gli argomenti sono racchiusi tra parentesi quadre, delimitati da spazi. Coordinate: gradi decimali (±180 long, ±90 lat). Larghezza e altezza devono essere < 25mi. Esempio: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] Nota: Non trova corrispondenze con Retweet o Quote Tweet.
profile_country	Trova corrispondenze con Post dove il codice paese geografico del profilo dell’autore corrisponde a un codice di due lettere ISO-3166-1-alpha-2 fornito.
profile_region	Trova corrispondenze nel campo “region” dall’arricchimento geografico del profilo dell’autore, una corrispondenza esatta della stringa completa. Usa le virgolette doppie per sottostringhe contenenti spazi o punteggiatura. Esempio: profile_region:"New York"
profile_locality	Trova corrispondenze nel campo “locality” dall’arricchimento geografico del profilo dell’autore, una corrispondenza esatta della stringa completa. Usa le virgolette doppie per sottostringhe contenenti spazi o punteggiatura. Esempio: profile_locality:"San Francisco"
profile_subregion	Trova corrispondenze nel campo “subRegion” dall’arricchimento geografico del profilo dell’autore, incluse contee specifiche o aree metropolitane. Una corrispondenza esatta della stringa completa. Esempio: profile_subregion:"Santa Clara County"
has:geo	Trova corrispondenze con Post che hanno dati di geolocalizzazione specifici del Post da X, inclusi dati di posizione “geo” lat-long o “Place” con un nome visualizzato e poligono geografico. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
has:profile_geo	Trova corrispondenze con Post che hanno qualsiasi metadata Profile Geo, indipendentemente dal valore. Alias disponibile: has:derived_user_geo. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
has:links	Trova corrispondenze con Post che hanno un link o media referenziato nell’oggetto “text” del payload, inclusi media e Quote Tweet. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
is:retweet	Restituisce solo retweet espliciti. Può essere negato per escludere i retweet e restituire solo contenuto originale. Questo operatore cerca solo veri Retweet e non Quote Tweet. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
is:reply	Restituisce solo risposte esplicite. Può essere negato per escludere le risposte. PowerTrack trova corrispondenze con risposte a Post originali, risposte in Post quotati e risposte in Retweet. L’API di ricerca trova corrispondenze solo con risposte a Post originali. Esempio: @XDevelopers -is:reply
is:quote	Restituisce solo Quote Tweet o Post che fanno riferimento a un altro Post. Può essere negato per escludere i Quote Tweet. Esempio: @XDevelopers is:quote
is:verified	Restituisce solo Post da autori “verificati”. Può essere negato per escludere Post da autori verificati. Esempio: @XDevelopers is:verified
has:mentions	Trova corrispondenze con Post che menzionano un altro utente X. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
has:hashtags	Trova corrispondenze con Post contenenti un hashtag. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
has:media	Trova corrispondenze con Post contenenti un URL media classificato da X (ad es., pic.x.com). Alias disponibile: has:media_link. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
has:images	Trova corrispondenze con Post contenenti un URL media (ad es., pic.x.com). Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
has:videos	Trova corrispondenze con Post contenenti video nativi X caricati su X. Alias disponibile: has:video_link. Questo operatore non trova corrispondenze con video da YouTube, Periscope o altri siti di hosting video. Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.
has:symbols	Trova corrispondenze con Post contenenti un simbolo cashtag (ad es., $TWTR). Nota: Con l’API di ricerca, deve essere combinato con operatori non-is: o has:.

​

Operatori per prodotto

​

Regole e filtraggio: Enterprise

Tutti gli operatori di livello Enterprise sono disponibili con le API PowerTrack e Historical PowerTrack. Tuttavia, solo un sottoinsieme di operatori è disponibile per le API di ricerca Enterprise, come indicato in questa pagina.

I tag blu scuro indicano quali operatori sono disponibili per i diversi prodotti Enterprise:

PowerTrack Search

Operatore	Prodotto	Descrizione	Corrisponde all’elemento del payload
”corrispondenza esatta della frase”	PowerTrack Search	Trova una corrispondenza esatta di una frase all’interno del corpo di un Post. I componenti che possono essere interpretati come operatori di ricerca verranno trattati come parole. In altre parole: _ "#hashtag" corrisponderà a hashtag ma non a #hashtag (usa l’operatore hashtag senza virgolette per trovare gli hashtag effettivi) _ "$TWTR" corrisponderà alla parola TWTR ma non al cashtag $TWTR (usa l’operatore cashtag senza virgolette per trovare i cashtag effettivi) Nota: in 30 Day Search e Full Archive Search (Enterprise e Premium), la punteggiatura non viene tokenizzata e viene invece trattata come spazio vuoto.	text
@	PowerTrack Search	Trova qualsiasi Post che menziona il nome utente specificato. Il valore può essere il nome utente (escludendo il carattere @) o l’ID numerico dell’utente (ottenuto ad esempio tramite l’endpoint GET users/lookup).	entities.user_mentions
#	PowerTrack Search	Trova qualsiasi Post con l’hashtag specificato. Questo operatore esegue una corrispondenza esatta. Ad esempio, la regola #1989 troverà i Post contenenti l’hashtag esatto #1989, ma non quelli con l’hashtag #TaylorSwift1989. Nota: questo operatore si basa sull’estrazione di entità di X per trovare gli hashtag, piuttosto che estrarre l’hashtag dal corpo stesso. Per maggiori dettagli sugli attributi JSON delle entità, consulta X Entities.	entities.hashtags
$	PowerTrack Search	Trova qualsiasi Post che contiene il cashtag specificato (dove il carattere iniziale del token è $). Nota: questo operatore si basa sull’estrazione di entità di X per trovare i link, piuttosto che estrarre il link dal corpo stesso. Per maggiori dettagli sugli attributi JSON delle entità, consulta X Entities.	entities.symbols
bio:	PowerTrack	Alias disponibile: user_bio: Trova una parola chiave (usando corrispondenza tokenizzata) o una frase all’interno della biografia utente di un Post. Usa le virgolette doppie per trovare una frase. In altre parole: _ bio:software engineer troverà i Post con la parola chiave engineer da utenti con la parola software nella loro biografia _ bio:"software engineer" troverà qualsiasi Post pubblicato da utenti con la frase software engineer nella loro biografia	user``.description
bio_location:	PowerTrack	Alias disponibile: user_bio_location: Trova i Post dove la posizione dell’oggetto utente contiene la parola chiave specificata (usando corrispondenza tokenizzata) o frase. Questa posizione è una stringa non normalizzata, generata dall’utente e in formato libero, ed è diversa dalla posizione di un Post (quando disponibile).	user.location
bio_name:	PowerTrack	Trova i Post dove il nome dell’oggetto utente contiene la parola chiave specificata (usando corrispondenza tokenizzata) o frase.	user.name
bounding_box:	PowerTrack Search	Alias disponibile: geo_bounding_box: Trova corrispondenze con la posizione esatta (long, lat) del Post (quando presente), e con un poligono geografico (dove il Place è completamente contenuto all’interno della regione definita). _ west_long south_lat rappresentano l’angolo sud-ovest del riquadro di delimitazione dove west-long è la longitudine di quel punto, e south_lat è la latitudine. _ east_long e north_lat rappresentano l’angolo nord-est del riquadro di delimitazione, dove east_long è la longitudine di quel punto, e north_lat è la latitudine. _ Larghezza e altezza del riquadro di delimitazione devono essere inferiori a 25 miglia _ La longitudine è nell’intervallo di ±180 _ La latitudine è nell’intervallo di ±90 _ Tutte le coordinate sono in gradi decimali. * Gli argomenti delle regole sono contenuti tra parentesi quadre, delimitati da spazi. Nota: gli operatori che trovano corrispondenze con il luogo (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	place (solo Post originali)
contains:	PowerTrack	Corrispondenza di sottostringa per Post che contengono la sottostringa specificata nel corpo, indipendentemente dalla tokenizzazione. In altre parole, questo esegue una corrispondenza di sottostringa pura e non considera i confini delle parole. Usa le virgolette doppie per trovare sottostringhe che contengono spazi vuoti o punteggiatura.	text
<emoji>	PowerTrack Search	Trova un emoji all’interno del corpo di un Post. Questa è una corrispondenza tokenizzata, quindi il tuo emoji sarà confrontato con il testo tokenizzato del corpo del Post. La tokenizzazione è basata su punteggiatura, simboli/emoji e caratteri separatori del piano base Unicode. Ad esempio, un Post con il testo “I like 🍕” sarebbe diviso nei seguenti token: I, like, 🍕. Questi token sarebbero poi confrontati con l’emoji usato nella tua regola. Nota: se un emoji ha una variante, devi usare le virgolette doppie per aggiungerlo a una regola.	text
followers_count:	PowerTrack	Trova i Post quando l’autore ha un numero di follower all’interno dell’intervallo specificato. _ Un singolo numero (ad es. followers_count:42) troverà qualsiasi numero uguale o maggiore del valore specificato. _ Un intervallo (ad es. followers_count:42..1337) troverà qualsiasi numero nell’intervallo specificato.	user.followers_count
friends_count:	PowerTrack	Alias disponibile: following_count: Trova i Post quando l’autore ha un numero di amici (il numero di utenti che segue) che rientra nell’intervallo specificato. _ Un singolo numero (ad es. followers_count:42) troverà qualsiasi numero uguale o maggiore del valore specificato. _ Un intervallo (ad es. followers_count:42..1337) troverà qualsiasi numero nell’intervallo specificato.	user.friends_count
from:	PowerTrack Search	Trova qualsiasi Post da un utente specifico. Il valore può essere il nome utente (escludendo il carattere @) o l’ID numerico dell’utente (ottenuto ad esempio tramite l’endpoint GET users/lookup).	user.id, user.id_str (se si usa l’ID utente) user.screen_name (se si usa il nome utente)
has:geo	PowerTrack Search	Trova i Post che hanno dati di geolocalizzazione specifici del Post forniti da X. Questi possono essere coordinate “geo” lat-long, o una “location” sotto forma di un Place di X, con il nome visualizzato corrispondente, poligono geografico e altri campi. Non può essere usato come operatore autonomo. Nota: gli operatori che trovano corrispondenze con il luogo (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	place (solo Tweet originali)
has:hashtags	PowerTrack Search	Trova corrispondenza con i Post che contengono almeno un hashtag. Non può essere utilizzato come operatore autonomo.	entities.hashtags
has:images	PowerTrack Search	Trova corrispondenza con i Post che contengono almeno un URL di immagine classificato. Non può essere utilizzato come operatore autonomo.	entities.media
has:lang	PowerTrack	Trova corrispondenza con i Post che sono stati classificati da X come appartenenti a una lingua specifica. Se un Post non è stato classificato, l’operatore non troverà corrispondenza. Ogni Post è attualmente classificato come appartenente a una sola lingua, quindi utilizzare l’operatore AND con più lingue non produrrà risultati. Non può essere utilizzato come operatore autonomo.	lang quando il valore non è und
has:links	PowerTrack Search	Questo operatore trova corrispondenza con i Post che contengono link nel corpo del Post. Non può essere utilizzato come operatore autonomo. Nota: questo operatore si basa sull’estrazione di entità di X per trovare corrispondenze con i link, piuttosto che estrarre il link dal corpo stesso. Per maggiori dettagli sugli attributi JSON delle entità, fare riferimento a X Entities.	entities.urls
has:media	PowerTrack Search	Alias disponibile: has:media_link Trova corrispondenza con i Post che contengono almeno un URL media classificato. Non può essere utilizzato come operatore autonomo.	entities.media
has:mentions	PowerTrack Search	Trova corrispondenza con i Post che menzionano un altro utente X. Non può essere utilizzato come operatore autonomo.	entities.user_mentions
has:profile_geo	PowerTrack Search	Alias disponibile: has:derived_user_geo Trova corrispondenza con i Post che hanno qualsiasi metadata Profile Geo, indipendentemente dal valore effettivo. Non può essere utilizzato come operatore autonomo.	user.location
has:symbols	PowerTrack Enterprise	Trova corrispondenza con i Post che contengono un simbolo cashtag (ad es. $TWTR). Non può essere utilizzato come operatore autonomo.	entities.symbols
has:videos	PowerTrack Search	Alias disponibile: has:video_link Trova corrispondenza con i Post che contengono almeno un URL media classificato. Non può essere utilizzato come operatore autonomo.	entities.media
in_reply_to_status_id:	PowerTrack	Alias disponibile: in_reply_to_tweet_id: Restituisce solo risposte esplicite al Post specificato.	id, id_str del Post di destinazione
is:quote	PowerTrack	Restituisce Quote Tweet espliciti che corrispondono a una regola. Può anche essere negato (-is:quote) per escludere i Quote Tweet che corrispondono a una regola dalla restituzione. Non può essere utilizzato come operatore autonomo.	is_quote_status (se true)
is:reply	PowerTrack Search	Restituisce solo risposte che corrispondono a una regola. Può anche essere negato (-is:reply) per escludere la restituzione di risposte che corrispondono alla regola specificata. Con PowerTrack, questo operatore trova corrispondenza con: _ Risposte a un Post originale _ Risposte in Post quotati * Risposte in Retweet Quando utilizzato con l’API Search, questo operatore trova corrispondenza con le risposte a un Post originale, ma esclude le risposte in Tweet quotati e le risposte in Retweet. È possibile utilizzare questo operatore insieme a is:retweet e is:quote per restituire solo risposte a Post originali. Non può essere utilizzato come operatore autonomo con l’API Search. Nota: con Premium, questo operatore non è disponibile negli ambienti di sviluppo Sandbox.	Elementi di risposta, ad es. in_reply_to_status_id
is:retweet	PowerTrack Search	Restituisce solo Retweet espliciti che corrispondono a una regola. Può anche essere negato (-is:retweet) per escludere i Retweet che corrispondono a una regola dalla restituzione e restituire solo contenuto originale. Questo operatore cerca solo veri Retweet (cioè Retweet pubblicati utilizzando il pulsante Retweet). Tweet quotati e Post modificati che non utilizzano la funzionalità Retweet di X non saranno trovati da questo operatore. Non può essere utilizzato come operatore autonomo.	Elementi Retweet, ad es. retweeted_status
is:verified	PowerTrack Search	Restituisce solo Post in cui l’autore è verificato da X. Può anche essere negato per escludere Post in cui l’autore è verificato. Non può essere utilizzato come operatore autonomo.	user.verified
keyword	PowerTrack Search	Trova corrispondenza con una parola chiave all’interno del corpo di un Post. Questa è una corrispondenza tokenizzata, il che significa che la stringa della parola chiave sarà confrontata con il testo tokenizzato del corpo del Post. La tokenizzazione si basa su punteggiatura, simboli/emoji e caratteri separatori del piano base Unicode. Ad esempio, un Post con il testo “I like coca-cola” sarebbe diviso nei seguenti token: I, like, coca, cola. Questi token sarebbero quindi confrontati con la stringa della parola chiave utilizzata nella regola. Per trovare corrispondenze con stringhe contenenti punteggiatura (ad es. coca-cola), simboli o caratteri separatori, è necessario utilizzare un operatore di corrispondenza esatta della frase.	text
lang:	PowerTrack Search	Trova corrispondenze con i Post che sono stati classificati da X come appartenenti a una particolare lingua (se e solo se il post è stato classificato). Ogni Post sarà classificato con una sola lingua, quindi utilizzare l’operatore AND insieme a più lingue non produrrà risultati. Nota: se non è possibile effettuare una classificazione linguistica, il risultato fornito è und (per indefinito). Questo operatore troverà corrispondenze solo con le lingue supportate. Fornire qualsiasi altro valore (incluso und) comporterà che l’operatore venga ignorato (in altre parole, i Post non saranno filtrati da questo operatore). L’elenco sottostante rappresenta le lingue attualmente supportate e il loro corrispondente identificatore di lingua BCP 47: am Amarico hu Ungherese pt Portoghese ar Arabo is Islandese ro Rumeno hy Armeno in Indonesiano ru Russo bn Bengalese it Italiano sr Serbo bg Bulgaro ja Giapponese sd Sindhi my Birmano kn Kannada si Singalese zh Cinese km Khmer sk Slovacco cs Ceco ko Coreano sl Sloveno da Danese lo Lao ckb Curdo Sorani nl Olandese lv Lettone es Spagnolo en Inglese lt Lituano sv Svedese et Estone ml Malayalam tl Tagalog fi Finlandese dv Maldiviano ta Tamil fr Francese mr Marathi te Telugu ka Georgiano ne Nepalese th Thai de Tedesco no Norvegese bo Tibetano el Greco or Oriya tr Turco gu Gujarati pa Panjabi uk Ucraino ht Haitiano ps Pashto ur Urdu iw Ebraico fa Persiano ug Uiguro hi Hindi pl Polacco vi Vietnamita cy Gallese	lang quando il valore non è und
listed_count:	PowerTrack	Alias disponibile: user_in_lists_count: Trova corrispondenze con i Post quando l’autore è stato inserito in liste su X un numero di volte che rientra nell’intervallo specificato. _ Un singolo numero (ad es. listed_count:42) troverà corrispondenze con qualsiasi numero uguale o maggiore del valore specificato. _ Un intervallo (ad es. listed_count:42..1337) troverà corrispondenze con qualsiasi numero nell’intervallo specificato.	user.listed_count
place_country:	PowerTrack Search	Trova corrispondenze con i Post dove il codice paese associato a un luogo/posizione taggato corrisponde al codice carattere alfa-2 ISO specificato. Nota: gli operatori che trovano corrispondenze sui luoghi (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	place (solo Post originali)
place:	PowerTrack Search	Trova corrispondenze con i Post taggati con la posizione specificata o ID luogo X. I nomi di luoghi composti da più parole dovrebbero essere racchiusi tra virgolette (ad es. place:"San Francisco") Nota: gli operatori che trovano corrispondenze sui luoghi (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	place (solo Post originali)
point_radius:	PowerTrack Search	Nota: gli operatori che trovano corrispondenze sui luoghi (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	place (solo Post originali)
profile_bounding_box:[west_long south_lat east_long north_lat]	PowerTrack	Trova corrispondenze con la Posizione esatta dell’utente (long, lat) nell’arricchimento Profile Geo dove il Luogo è completamente contenuto all’interno della regione definita. _ west_long south_lat rappresentano l’angolo sud-ovest del riquadro di delimitazione dove west-long è la longitudine di quel punto, e south_lat è la latitudine. _ east_long e north_lat rappresentano l’angolo nord-est del riquadro di delimitazione, dove east_long è la longitudine di quel punto, e north_lat è la latitudine. _ Larghezza e altezza del riquadro di delimitazione devono essere inferiori a 25 miglia _ La longitudine è nell’intervallo di ±180 _ La latitudine è nell’intervallo di ±90 _ Tutte le coordinate sono in gradi decimali. * Gli argomenti delle regole sono contenuti tra parentesi quadre, delimitati da spazi. Nota: gli operatori che trovano corrispondenze sui luoghi (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	user.derived.locations.geo.coordinates
profile_country:	PowerTrack Search	Corrispondenza esatta sul codice paese dall’arricchimento Profile Geo. Utilizza un set normalizzato di codici paese a due lettere, basato sulla specifica ISO-3166-1-alpha-2. Per essere concisi, questo operatore è fornito al posto di un operatore per il campo paese dall’oggetto indirizzo. Nota: gli operatori che trovano corrispondenze sui luoghi (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	user.derived.locations.country_code
profile_locality:	PowerTrack Search	Corrispondenza esatta sul campo Località dall’arricchimento Profile Geo. Questa è una corrispondenza esatta di stringa completa. Non è necessario utilizzare il carattere di escape backslash. Ad esempio, se si cerca una corrispondenza con qualcosa che contiene una barra, utilizzare one/two. Utilizzare le virgolette doppie per trovare corrispondenze con sottostringhe che contengono spazi bianchi o punteggiatura, ad es. profile_locality:"Lower East Side".	user.derived.locations.locality
profile_point_radius:[lon lat radius]	PowerTrack	Trova corrispondenze con la Posizione Esatta (x,y) dell’arricchimento Profile Geo dell’utente. _ Le unità di raggio supportate sono miglia (mi) e chilometri (km). _ Il raggio deve essere inferiore a 25 miglia. _ La longitudine è nell’intervallo di ±180 _ La latitudine è nell’intervallo di ±90 _ Tutte le coordinate sono in gradi decimali. _ Gli argomenti delle regole sono contenuti tra parentesi quadre, delimitati da spazi. Nota: gli operatori che trovano corrispondenze sui luoghi (geo del Post) includeranno solo corrispondenze dai Post originali. I Retweet non contengono dati di luogo.	user.derived.locations.geo
profile_region:	PowerTrack Search	Corrispondenza esatta sul campo Region dall’arricchimento Profile Geo. Si tratta di una corrispondenza esatta dell’intera stringa. Non è necessario utilizzare il carattere di escape backslash. Ad esempio, per trovare corrispondenza con qualcosa che contiene una barra, utilizzare one/two. Utilizzare le virgolette doppie per trovare corrispondenza con sottostringhe che contengono spazi o punteggiatura, ad esempio profile_locality:"New York".	user.derived.locations.region
profile_subregion:	PowerTrack	Corrispondenza esatta sul campo Subregion dall’arricchimento Profile Geo. Si tratta di una corrispondenza esatta dell’intera stringa. Non è necessario utilizzare il carattere di escape backslash. Ad esempio, per trovare corrispondenza con qualcosa che contiene una barra, utilizzare one/two. Utilizzare le virgolette doppie per trovare corrispondenza con sottostringhe che contengono spazi o punteggiatura, ad esempio profile_locality:"Kings County".	user.derived.locations.sub_region
”keyword1 keyword2”~N	PowerTrack Search	Comunemente chiamato operatore di prossimità, trova corrispondenza con un Post in cui le parole chiave non distano più di N token l’una dall’altra. Se le parole chiave sono nell’ordine opposto, non possono distare più di N-2 token l’una dall’altra. Può contenere qualsiasi numero di parole chiave tra virgolette. N non può essere maggiore di 6.	text
retweets_of_status_id:	PowerTrack	Alias disponibile: retweets_of_tweet_id: Restituisce solo Retweet espliciti del Post originale specificato.	retweeted_status.id, retweeted_status.id_str
retweets_of:	PowerTrack Search	Alias disponibile: retweets_of_user: Trova corrispondenza con qualsiasi Post che sia un Retweet dell’utente specificato. Il valore può essere il nome utente (escludendo il carattere @) o l’ID numerico dell’utente (ottenuto ad esempio tramite l’endpoint GET users/lookup).	retweeted_status.id (se presente)
sample:	PowerTrack	Restituisce un campione percentuale casuale di Post che corrispondono a una regola anziché l’intero insieme di Post. Il valore percentuale deve essere rappresentato da un numero intero compreso tra 1 e 100. Questo operatore si applica all’intera regola e richiede che tutti i termini in OR siano raggruppati. Nota: l’operatore sample riduce prima l’ambito del firehose a X%, quindi la regola/filtro viene applicata a quel sottoinsieme campionato. Se si utilizza, ad esempio, sample:10, ogni Post ha una probabilità del 10% di essere incluso nel campione. Nota: il campionamento è deterministico e si otterranno gli stessi dati campione in tempo reale come se si estraessero i dati storicamente.
source:	PowerTrack	Trova corrispondenza con qualsiasi Post generato dall’applicazione sorgente specificata. Il valore deve essere il nome dell’applicazione o l’URL dell’applicazione. Non può essere utilizzato come operatore autonomo.	source
statuses_count:	PowerTrack	Alias disponibile: tweets_count: Trova corrispondenza con Post quando l’autore ha pubblicato un numero di status che rientra nell’intervallo specificato. _ Un singolo numero (ad esempio statuses_count:42) troverà corrispondenza con qualsiasi numero uguale o maggiore del valore specificato. _ Un intervallo (ad esempio statuses_count:42..1337) troverà corrispondenza con qualsiasi numero nell’intervallo specificato.	user``.statuses_count
to:	PowerTrack Search	Trova corrispondenza con qualsiasi Post che sia in risposta a un utente particolare. Il valore può essere il nome utente (escludendo il carattere @) o l’ID numerico dell’utente (ottenuto ad esempio tramite l’endpoint GET users/lookup).	text
url:	PowerTrack Search	Esegue una corrispondenza tokenizzata sugli URL espansi di un Post. Token e frasi contenenti punteggiatura o caratteri speciali devono essere racchiusi tra virgolette doppie (ad esempio url:"/developer"). Sebbene generalmente non raccomandato, l’operatore può anche trovare corrispondenza su un protocollo specifico, racchiuso tra virgolette doppie (ad esempio url:"https://developer.x.com").	entities.urls.expanded_url
url_contains:	PowerTrack	Esegue una corrispondenza di parola chiave/frase sul (nuovo) arricchimento metadata del titolo URL espanso.	entities.urls.expanded_url
url_description:	PowerTrack	Alias disponibile: within_url_description: Esegue una corrispondenza di parola chiave/frase sul (nuovo) arricchimento metadata della descrizione della pagina espansa.	entities.urls.unwound.description
url_title:	PowerTrack	Alias disponibile: within_url_title: Esegue una corrispondenza di parola chiave/frase sul (nuovo) arricchimento metadata del titolo URL espanso.	entities.urls.title