Vai al contenuto principale
Il gruppo di endpoint filtered stream consente agli sviluppatori di filtrare uno stream di Post pubblici. La funzionalità di questo gruppo include più endpoint che permettono di creare e gestire regole e di applicarle per filtrare uno stream di Post che restituirà i Post pubblici corrispondenti. Questo gruppo di endpoint consente agli utenti di monitorare argomenti ed eventi specifici, seguire la conversazione intorno a competizioni, capire come si sviluppano i trend e molto altro. Gli sviluppatori possono utilizzare l’endpoint delle regole REST per aggiungere e rimuovere regole a una connessione di stream persistente senza doverla disconnettere. Queste regole possono essere create con operatori che effettuano il matching su attributi del Post come parole chiave, hashtag e URL. Gli operatori e le clausole di regola possono essere combinati con logica booleana e parentesi per affinare il comportamento di corrispondenza del filtro. Una volta aggiunto un set di regole, puoi stabilire una connessione di streaming che inizierà a consegnare Oggetti Post in formato JSON tramite una connessione HTTP di streaming persistente. Riceverai solo contenuti che corrispondono alle tue regole mentre sei connesso allo stream. In alternativa, puoi collegare il Filtered Stream a un webhook per la consegna come eventi di webhook. Per maggiori dettagli sull’uso dei webhook con Filtered Stream, consulta l’introduzione ai webhook del Filtered Stream. L’endpoint di ricerca filtrata supporta i Post modificati. Questo endpoint fornirà i Post modificati che corrispondono a uno o più dei tuoi filtri, insieme alla loro cronologia delle modifiche, inclusa una array di ID del Post. Per i Post senza cronologia delle modifiche, questa array conterrà un singolo ID. Per i Post modificati, questa array contiene più ID, disposti in ordine crescente a riflettere l’ordine delle modifiche, con la versione più recente nell’ultima posizione dell’array. Per saperne di più su come funzionano le modifiche ai Post, consulta la pagina Nozioni fondamentali sulle modifiche ai Post. Determinati aspetti dell’endpoint filtered stream sono limitati in base al livello di accesso: Accesso Pro
  • 1000 regole per progetto
  • 100 richieste ogni 15 minuti quando si utilizza l’endpoint POST /2/tweets/search/stream/rules per aggiungere regole
  • Possibilità di utilizzare tutti gli operatori durante la creazione della regola
  • Possibilità di creare regole fino a 1024 caratteri di lunghezza
Accesso Enterprise
  • Oltre 25.000 regole per progetto
  • Possibilità di utilizzare tutti gli operatori durante la creazione della regola
  • Possibilità di creare regole fino a 2048 caratteri di lunghezza
  • Richiedi l’accesso Enterprise qui
I Post restituiti dal filtered stream concorrono al Post cap mensile.
Configurazione dell’accountPer accedere a questi endpoint, avrai bisogno di:Scopri di più su come ottenere l’accesso agli endpoint di X API v2 nella nostra guida introduttiva.
⌘I