Vai al contenuto principale
La ricerca dei Post è una funzionalità importante per mettere in evidenza le conversazioni su X relative a un argomento o evento specifico. Sebbene questa funzionalità sia presente su X, questi endpoint offrono maggiore flessibilità e potenza nel filtrare e acquisire Post, così da trovare più facilmente i dati rilevanti per le tue ricerche; sviluppare applicazioni di “ascolto” quasi in tempo reale; oppure, in generale, esplorare, analizzare e/o intervenire sui Post relativi a un argomento di interesse.  Offriamo due endpoint che consentono di cercare Post: ricerca recente e ricerca su archivio completo. Entrambi questi endpoint REST condividono progettazione e funzionalità comuni, incluso l’utilizzo di un’unica query di ricerca per filtrare i Post attorno a un argomento specifico. Queste query di ricerca vengono create con un insieme di operatori che eseguono il match su attributi dei Post e degli utenti, come parole chiave del messaggio, hashtag e URL. Gli operatori possono essere combinati in query con logica booleana e parentesi per affinare il comportamento di corrispondenza.  Sia l’endpoint di ricerca recente sia quello di ricerca su archivio completo forniscono i metadati di modifica del Post. Tutti gli oggetti relativi ai Post creati dal 29 settembre 2022 includono metadati di modifica del Post, anche se il Post non è mai stato modificato. Ogni volta che un Post viene modificato, viene creato un nuovo ID del Post. La cronologia delle modifiche di un Post è documentata da un array di ID del Post, a partire dall’ID originale. Questi endpoint restituiscono sempre l’ultima modifica disponibile, insieme all’eventuale cronologia delle modifiche. Qualsiasi Post raccolto dopo la finestra di modifica di 30 minuti rappresenterà la sua versione finale. Per saperne di più sui metadati di Edit Post, consulta la pagina Edit Posts fundamentals. Una volta impostata la query e iniziata la ricezione dei Post, questi endpoint supportano la navigazione dei risultati sia per intervalli temporali sia per intervalli di ID del Post. Questo è pensato per supportare due casi d’uso comuni: 
  • Recupero storico: le richieste riguardano un periodo di interesse, senza concentrarsi sulla natura in tempo reale dei dati. Viene effettuata una singola richiesta e tutti i dati corrispondenti vengono restituiti utilizzando la paginazione, se necessario. Questa è la modalità predefinita per Search Posts.
  • Polling o listening: le richieste vengono effettuate in modalità “ci sono nuovi Post dalla mia ultima richiesta?”. Le richieste sono inviate in modo continuativo e in genere il caso d’uso è focalizzato su un “ascolto” quasi in tempo reale dei Post di interesse.
Molti operatori e limiti della query sono esclusivi dell’Enterprise access, il che significa che devi utilizzare chiavi e token da un’App all’interno di un Project con accesso Enterprise per sfruttare le funzionalità aggiuntive. Puoi saperne di più nelle sezioni degli endpoint riportate di seguito. Sia l’endpoint di ricerca recente sia quello di ricerca su archivio completo contribuiscono al Post cap mensile per i Post restituiti. Configurazione dell’account Per accedere a questi endpoint, ti servirà: Scopri di più su come ottenere l’accesso agli endpoint della X API v2 nella nostra guida introduttiva. L’endpoint di ricerca recente consente di accedere programmaticamente ai Post pubblici filtrati pubblicati nell’ultima settimana, ed è disponibile per tutti gli sviluppatori che dispongono di un account sviluppatore e utilizzano chiavi e token da un’App all’interno di un Project. È possibile autenticare le richieste con Contesto utente OAuth 1.0a, OAuth 2.0 App-Only, o OAuth 2.0 Authorization Code con PKCE. Tuttavia, per ricevere metriche private o una suddivisione delle metriche organiche e promosse nei risultati dei Post, sarà necessario utilizzare Contesto utente OAuth 1.0a o OAuth 2.0 Authorization Code con PKCE, e fornire Access Token utente associati all’utente che ha pubblicato il contenuto specifico. Questo endpoint può restituire fino a 100 Post per richiesta in ordine cronologico inverso, e vengono forniti token di paginazione per navigare attraverso grandi set di Post corrispondenti. Quando si utilizza un Project con accesso regolare, è possibile utilizzare il set base di operatori ed effettuare query fino a 512 caratteri di lunghezza. Quando si utilizza un Project con accesso Enterprise, si ha accesso a operatori aggiuntivi. I Project con accesso Enterprise possono effettuare query fino a 4096 caratteri di lunghezza. Ulteriori informazioni sui livelli di accesso.

​
Ricerca nell’archivio completo

L’endpoint di ricerca nell’archivio completo v2 è disponibile solo per i Project con accesso Pro e Enterprise. L’endpoint consente di accedere in modo programmatico ai Post pubblici dall’archivio completo, risalente al primo Post del marzo 2006, in base alla tua query di ricerca. Puoi autenticare le richieste a questo endpoint utilizzando OAuth 2.0 App-Only e l’App Access Token deve provenire da un’App inclusa in un Project con accesso Pro o Enterprise. Poiché con questo endpoint non puoi effettuare richieste per conto di altri utenti (Contesto utente OAuth 1.0a o OAuth 2.0 Authorization Code con PKCE), non potrai ottenere metriche private. Questo endpoint può restituire fino a 500 Post per richiesta in ordine cronologico inverso e vengono forniti token di paginazione per scorrere insiemi di Post corrispondenti di grandi dimensioni. Nota: se richiedi le annotations tramite il parametro tweet.fields, il parametro max_results è attualmente limitato a un valore massimo di 100. Questo potrebbe cambiare in futuro, ma tieni presente questa limitazione. Poiché questo endpoint è disponibile solo per chi è stato approvato per l’accesso Pro ed Enterprise, hai accesso all’insieme completo di operatori di ricerca e puoi inviare query fino a 1024 caratteri.







Risorse di supporto Scopri come usare Postman per effettuare richieste Risoluzione dei problemi Visita la pagina di riferimento dell’API
⌘I