| Novità della X API v2 | Scopri i nuovi endpoint e le funzionalità che abbiamo introdotto nella X API v2. |
|---|---|
| Pronto per la migrazione? | Avvia la migrazione con una serie di guide e istruzioni. |
| Guida alla migrazione del formato dei dati | Scopri come adattare i parser dei dati che in precedenza funzionavano con Standard v1.1 e con i formati Enterprise. |
| Mappa degli endpoint della X API | Scopri come gli endpoint Standard v1.1 e Enterprise corrispondono ai nuovi endpoint della X API v2. |
Che cos’è la X API v2?
La X API v2 è ora l’API principale di X ed è il centro degli investimenti e dell’innovazione di prodotto. Abbiamo collaborato con gli sviluppatori per creare la nuova generazione della X API, così da servire meglio la nostra eterogenea comunità di sviluppatori. Sulla base dei loro riscontri, abbiamo ricostruito l’API per rispondere a un ventaglio più ampio di esigenze, introdotto nuove funzionalità ed endpoint e migliorato l’esperienza degli sviluppatori. La X API v2 è ora l’API principale di X ed è il centro degli investimenti e dell’innovazione di prodotto. Negli ultimi anni abbiamo collaborato con gli sviluppatori e ricostruito l’API per rispondere a un ventaglio più ampio di esigenze, introdurre nuove funzionalità ed endpoint e migliorare l’esperienza degli sviluppatori. Siamo impegnati a continuare a costruire una piattaforma aperta per gli sviluppatori e siamo entusiasti di vedere cosa realizzerete con la X API v2.Perché migrare?
Endpoint v2
- Endpoint Spaces per aiutare le persone a ottenere il massimo da X Spaces e consentire agli sviluppatori di contribuire a plasmare il futuro delle conversazioni audio.
- Nascondi risposte, che consente di creare strumenti per limitare su larga scala l’impatto di risposte abusive, fuorvianti o distraenti.
- Nuovi endpoint List che consentono di fissare e rimuovere le List dai fissati o cercare le List fissate di un account.
- Nuovi endpoint di conformità batch che consentono di garantire la conformità dei dati utente e dei Tweet archiviati.
Nuove funzionalità
- Un design coerente tra gli endpoint
- La possibilità di specificare quali fields e oggetti restituire nel payload della risposta
- Nuovi oggetti dati più dettagliati
- Ricezione e filtraggio dei dati con nuove informazioni contestuali abilitate dalle Tweet annotations
- Accesso a nuove metriche
- Identificazione e filtraggio semplificati delle conversazioni appartenenti a un thread di risposte
- Funzionalità avanzate e maggiore accesso ai dati per i ricercatori accademici
- Funzionalità di ripristino e ridondanza per gli endpoint di streaming
- Restituzione semplificata dei conteggi dei Tweet che corrispondono a una query
- Supporto per Edit Tweets
- Filtraggio antispam ad alta affidabilità
- Gli URL abbreviati vengono completamente espansi per un filtraggio e un’analisi più efficaci
- Oggetti di risposta JSON semplificati, con rimozione dei campi deprecati e modernizzazione delle etichette
- Restituzione del 100% dei Tweet pubblici e disponibili corrispondenti nelle query di ricerca
- “Regole” di streaming per poter apportare modifiche senza interrompere le connessioni
- Linguaggio di query più espressivo per la ricerca dei Tweet, i conteggi dei Tweet e il filtered stream
- Specifica OpenAPI per creare nuove librerie e tracciare le modifiche in modo più trasparente
Scopri i nuovi oggetti di risposta e quelli aggiornati
| Object | Description |
|---|---|
| Tweet | L’oggetto Tweet ha un lungo elenco di campi di livello radice, come id, text e created_at. Gli oggetti Tweet sono anche l’oggetto padre di diversi oggetti figli, tra cui user, media, poll e place. |
| User | L’oggetto utente contiene i metadata dell’account utente di X che descrivono l’utente di riferimento. |
| Spaces | L’oggetto Space è composto da campi come state, host_id, is_ticketed e lang. |
| Lists | L’oggetto List contiene informazioni di base sulla List richiesta, inclusi description, member_count e owner_id. |
| Media | Se un Tweet contiene contenuti multimediali (ad esempio immagini), l’oggetto media può essere richiesto usando il parametro media.fields e include campi come media_key, type, url, preview_image_url e altro. |
| Poll | Un sondaggio incluso in un Tweet non è un oggetto primario in alcun endpoint, ma può essere individuato ed espanso all’interno dell’oggetto Tweet. |
| Place | L’oggetto place è composto da campi come place_id, oggetto geo, country_code e altro. Queste informazioni possono essere utilizzate per identificare i Tweet e analizzarli in base alla località. |
Flessibilità nella scelta degli oggetti e dei fields da ricevere
id e text come predefiniti.
Se desideri recuperare fields aggiuntivi con la tua richiesta, devi utilizzare i parametri fields ed expansions. Il parametro expansions consente di recuperare oggetti di data correlati, come il Tweet fissato di un utente o un oggetto media, mentre gli operatori dei fields consentono di richiedere specifici fields all’interno degli oggetti restituiti oltre ai predefiniti.
Di seguito trovi l’elenco completo delle expansions che puoi richiedere con i diversi endpoint di X API v2:
| Object / Resource | Available Expansions |
|---|---|
| Tweets | author_id, edit_history_tweet_ids, entities.mentions.username, in_reply_to_user_id, referenced_tweets.id, referenced_tweets.id.author_id, attachments.poll_ids, attachments.media_keys, geo.place_id |
| Users | pinned_tweet_id |
| Spaces | invited_user_ids, speaker_ids, creator_id, host_ids, topic_ids |
Nuove metriche disponibili per Tweet, utenti, Spaces e oggetti multimediali
| Object | Available Metrics | Public Metrics | Private Metrics | Organic Metrics | Promoted Metrics |
|---|---|---|---|---|---|
| tweets | retweet_count | ✔️ | ✔️ | ✔️ | |
| quote_count | ✔️ | ||||
| like_count | ✔️ | ✔️ | ✔️ | ||
| reply_count | ✔️ | ✔️ | ✔️ | ||
| impression_count | ✔️ | ✔️ | ✔️ | ||
| url_profile_clicks | ✔️ | ✔️ | ✔️ | ||
| url_link_clicks | ✔️ | ✔️ | ✔️ | ||
| user | follower_count | ✔️ | |||
| user | following_count | ✔️ | |||
| media | view_count | ✔️ | |||
| media | playback_0_count | ✔️ | |||
| space | participant_count | ✔️ |
Modifica dei Tweet
- Se un Tweet era idoneo alla modifica al momento della creazione. Alcuni Tweet, come quelli con sondaggi o i Tweet programmati, non possono essere modificati.
- Che i Tweet sono modificabili per 30 minuti e possono essere modificati fino a 5 volte. Per i Tweet modificabili è possibile vedere se rimane tempo per modificare e quante altre modifiche sono ancora disponibili.
- Se si sta visualizzando una versione modificata di un Tweet (nella maggior parte dei casi l’API restituirà la versione più recente di un Tweet, a meno che non venga richiesta una specifica versione precedente tramite id del Tweet).
- L’intera cronologia delle modifiche del Tweet.
- Le metriche di coinvolgimento attribuite a ciascuna versione del Tweet.
Tracciare le conversazioni con thread
Pronto per la migrazione
- Un account sviluppatore
- Un’App sviluppatore creata all’interno di un Project
- Chiavi e token dall’App sviluppatore di quel Project
Autenticazione
Strumenti e codice
- Mettiamo a disposizione una raccolta Postman per Twitter che ti consente di usare il client Postman per inviare richieste e connetterti ai singoli endpoint. È un modo semplice per testare l’autenticazione e sperimentare con gli endpoint.
- Abbiamo inoltre fornito un elenco di librerie sia supportate da Twitter sia di terze parti in Ruby, Python, Node, Java e molte altre. Per maggiori dettagli, consulta la nostra pagina su strumenti e librerie.
Migrazione agli endpoint aggiornati
- Tweet
- Utenti
- List
Migrazione al nuovo formato dei dati
- Formato nativo a X API v2 (Standard v1.1)
- Native Enriched a X API v2 (Enterprise)
- Activity Streams a X API v2 (Enterprise)