Modello a oggetti
Tweet
id, text e created_at. Gli oggetti Tweet sono anche l’oggetto “genitore” di diversi oggetti “figlio”, tra cui user, media, poll e place. Usa il parametro tweet.fields quando richiedi questi campi di livello radice sull’oggetto Tweet.
L’oggetto Tweet può essere trovato ed espanso nella risorsa utente. Ulteriori Tweet correlati al Tweet richiesto possono essere trovati ed espansi anche nella risorsa Tweet. L’oggetto è disponibile per l’espansione con ?expansions=pinned_tweet_id nella risorsa utente o con ?expansions=referenced_tweets.id nella risorsa Tweet per ottenere l’oggetto con i soli campi predefiniti. Usa l’espansione insieme al parametro tweet.fields quando richiedi campi aggiuntivi per completare l’oggetto.
| Valore del Campo | Tipo | Descrizione | Come Può Essere Utilizzato |
|---|---|---|---|
| id (predefinito) | string | L’identificatore univoco del Tweet richiesto. | Utilizzalo per recuperare programmaticamente un Tweet specifico. |
| text (predefinito) | string | Il testo UTF-8 effettivo del Tweet. Vedi twitter-text per dettagli sui caratteri validi. | Estrazione di parole chiave e analisi/classificazione del sentiment. |
| edit_history_tweet_ids (predefinito) | object | Identificatori univoci che indicano tutte le versioni di un Tweet. Per Tweet senza modifiche, ci sarà un ID. Per Tweet con cronologia di modifiche, ci saranno più ID. | Utilizza queste informazioni per trovare la cronologia di modifiche di un Tweet. |
| article | object | Contiene metadata per l’Articolo presente in questo Tweet. | Utilizzalo per ottenere il testo e le entità di un Articolo. |
| attachments | object | Specifica il tipo di allegati (se presenti) in questo Tweet. | Comprensione degli oggetti restituiti per le espansioni richieste. |
| author_id | string | L’identificatore univoco dell’Utente che ha pubblicato questo Tweet. | Idratazione dell’oggetto utente, condivisione del dataset per revisione tra pari. |
| card_uri | string | L’URI per la Card presente in questo tweet. | |
| community_id | string | L’identificatore univoco per la Community a cui appartiene questo Post. | |
| context_annotations | array | Contiene annotazioni di contesto per il Tweet. | Riconoscimento/estrazione di entità, analisi tematica. |
| conversation_id | string | L’ID del Tweet originale della conversazione (che include risposte dirette, risposte alle risposte). | Utilizzalo per ricostruire la conversazione da un Tweet. |
| created_at | date (ISO 8601) | Ora di creazione del Tweet. | Utile per l’analisi delle serie temporali e per comprendere quando è stato creato un Tweet. |
| display_text_range | array | Un array contenente un indice di inizio e fine per la porzione di testo che viene visualizzata. | Utile per sapere quale porzione di testo viene visualizzata per impostazione predefinita per i post lunghi. |
| edit_controls | object | Indica per quanto tempo ancora il Tweet può essere modificato e il numero di modifiche rimanenti. | Utilizzalo per determinare se un Tweet è idoneo per la modifica. |
| entities | object | Entità che sono state estratte dal testo del Tweet. Vedi entità negli Oggetti Twitter. | Fornisce informazioni aggiuntive su hashtag, URL, menzioni, ecc. |
| geo | object | Indica la posizione o il luogo di un Tweet geo-taggato. | Utilizzalo per determinare la posizione di un Tweet geo-taggato. |
| in_reply_to_user_id | string | Se il Tweet rappresentato è una risposta, questo campo conterrà l’ID dell’autore del Tweet originale. | Determina se un Tweet era in risposta a un altro Tweet. |
| lang | string | Lingua del Tweet, se rilevata da Twitter. | Classifica i Tweet per lingua parlata. |
| non_public_metrics | object | Metriche di coinvolgimento non pubbliche per il Tweet al momento della richiesta. Richiede autenticazione del contesto utente. | Determina le impressioni totali generate per il Tweet. |
| note_tweet | object | Contiene il testo completo di un Post per Post di forma lunga (>280 caratteri). | Ottieni il testo completo di un post. |
| organic_metrics | object | Metriche di coinvolgimento, tracciate in un contesto organico, per il Tweet al momento della richiesta. Richiede autenticazione del contesto utente. | Misura il coinvolgimento organico per il Tweet. |
| possibly_sensitive | boolean | Indica se il contenuto può essere riconosciuto come sensibile. | Studia la circolazione di certi tipi di contenuto. |
| promoted_metrics | object | Metriche di coinvolgimento, tracciate in un contesto promosso, per il Tweet al momento della richiesta. Richiede autenticazione del contesto utente. | Misura il coinvolgimento per il Tweet quando è stato promosso. |
| public_metrics | object | Metriche di coinvolgimento pubbliche per il Tweet al momento della richiesta. | Misura il coinvolgimento del Tweet. |
| referenced_tweets | array | Un elenco di Tweet a cui questo Tweet fa riferimento, come Retweet, Tweet citati o risposte. | Comprendi gli aspetti conversazionali dei retweet, ecc. |
| reply_settings | string | Mostra chi può rispondere a un determinato Tweet. Le opzioni sono “everyone”, “mentioned_users” e “followers”. | Determina le impostazioni di risposta della conversazione per il Tweet. |
| withheld | object | Contiene dettagli di trattenimento per contenuto trattenuto. | |
| scopes | object | Contiene dettagli dell’ambito per il tweet. | Indica chi può visualizzare il post. Restituito solo per post promossi. |
| media_metadata | array | Contiene metadata per gli allegati multimediali del Tweet. | Ottieni metadata aggiuntivi come l’alt_text di un allegato multimediale del Tweet. |
$BEARER_TOKEN con il tuo Bearer Token generato.
Utente
user.fields.
L’oggetto utente può anche comparire come oggetto figlio ed essere espanso all’interno dell’oggetto Tweet. È disponibile per l’espansione con ?expansions=author_id o ?expansions=in_reply_to_user_id per ottenere l’oggetto ridotto ai soli campi predefiniti. Usa l’expansion insieme al parametro user.fields quando richiedi campi aggiuntivi per completare l’oggetto.
| Valore del campo | Tipo | Descrizione | Come può essere utilizzato |
|---|---|---|---|
| id (default) | string | L’identificatore univoco di questo utente."id": "2244994945" | Utilizzalo per recuperare programmaticamente informazioni su un utente X specifico. |
| name (default) | string | Il nome dell’utente, come definito nel proprio profilo. Non necessariamente il nome di una persona. Tipicamente limitato a 50 caratteri, ma soggetto a modifiche."name": "Twitter Dev" | |
| username (default) | string | Il nome utente, handle o alias di X con cui questo utente si identifica. I nomi utente sono univoci ma soggetti a modifiche. Tipicamente di massimo 15 caratteri, ma alcuni account storici potrebbero esistere con nomi più lunghi."username": "TwitterDev" | |
| affiliation | object | Contiene dettagli sull’affiliazione di un utente. | Può essere utilizzato per ottenere il badge di affiliazione di un utente. |
| confirmed_email | string | L’email confermata dell’utente autenticato. | |
| connection_status | array | Fornisce un elenco delle relazioni tra l’utente che si autentica e l’utente che viene cercato, come following, followed, richiesta di follow inviata, richiesta di follow ricevuta, blocking, muting ”connection_status”: [ “follow_request_received”, “follow_request_sent”, “blocking”, “followed_by”, “following”, “muting” ] | Può essere utilizzato per determinare lo stato della connessione tra l’utente che si autentica e l’utente che viene cercato. |
| created_at | date (ISO 8601) | La data e ora UTC in cui l’account utente è stato creato su X."created_at": "2013-12-14T04:35:55.000Z" | Può essere utilizzato per determinare da quanto tempo qualcuno utilizza X |
| description | string | Il testo della descrizione del profilo di questo utente (nota anche come bio), se l’utente ne ha fornita una."description": "The voice of the X Dev team and your official source for updates, news, and events, related to the X API." | |
| entities | object | Contiene dettagli sul testo che ha un significato speciale nella descrizione dell’utente."entities": { <br/> "url": { <br/> "urls": [ <br/> { <br/> "start": 0, <br/> "end": 23, <br/> "url": "https://t.co/3ZX3TNiZCY", <br/> "expanded_url": "/content/developer-twitter/en/community", <br/> "display_url": "developer.x.com/en/community" <br/> } <br/> ] <br/> }, <br/> "description": { <br/> "urls": [ <br/> { <br/> "start": 0, <br/> "end": 23, <br/> "url": "https://t.co/3ZX3TNiZCY", <br/> "expanded_url": "/content/developer-twitter/en/community", <br/> "display_url": "developer.x.com/en/community" <br/> }, <br/> "hashtags": [ <br/> { <br/> "start": 23, <br/> "end": 30, <br/> "tag": "DevRel" <br/> }, <br/> { <br/> "start": 113, <br/> "end": 130, <br/> "tag": "BlackLivesMatter" <br/> }, <br/> "mentions": [ <br/> { <br/> "start": 0, <br/> "end": 10, <br/> "tag": "TwitterDev" <br/> }, <br/> "cashtags": [ <br/> { <br/> "start": 12, <br/> "end": 16, <br/> "tag": "twtr" <br/> } <br/> ] <br/> } <br/> } | Le entità sono oggetti JSON che forniscono informazioni aggiuntive su hashtag, URL, menzioni utente e cashtag associati alla descrizione. Consulta ciascuna entità rispettiva per ulteriori dettagli. Tutti gli indici start dell’utente sono inclusivi, mentre tutti gli indici end dell’utente sono esclusivi. |
| is_identity_verified | boolean | Indica se l’utente ha l’identità verificata. | |
| location | string | La posizione specificata nel profilo dell’utente, se l’utente ne ha fornita una. Poiché si tratta di un valore a forma libera, potrebbe non indicare una posizione valida, ma può essere valutata in modo approssimativo quando si eseguono ricerche con query di posizione."location": "127.0.0.1" | |
| most_recent_tweet_id | string | Identificatore univoco del Tweet più recente di questo utente. | Consente di determinare il Tweet più recente dell’utente. |
| parody | boolean | Indica se questo account utente ha o meno l’etichetta Parodia. | |
| pinned_tweet_id | string | Identificatore univoco del Tweet fissato di questo utente."pinned_tweet_id": "1255542774432063488" | Consente di determinare il Tweet fissato in cima al profilo dell’utente. Può potenzialmente essere utilizzato per determinare la lingua dell’utente. |
| profile_banner_url | string | L’URL del banner del profilo per questo utente, come mostrato nel profilo dell’utente."profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1721022977" | Può essere utilizzato per scaricare il banner del profilo di questo utente. |
| profile_image_url | string | L’URL dell’immagine del profilo per questo utente, come mostrata nel profilo dell’utente."profile_image_url": "https://pbs.twimg.com/profile_images/1267175364003901441/tBZNFAgA_normal.jpg" | Può essere utilizzato per scaricare l’immagine del profilo di questo utente. |
| protected | boolean | Indica se questo utente ha scelto di proteggere i propri Tweet (in altre parole, se i Tweet di questo utente sono privati)."protected": false | |
| public_metrics | object | Contiene dettagli sull’attività per questo utente."public_metrics": { "followers_count": 507902, "following_count": 1863, "tweet_count": 3561, "listed_count": 1550 } | Può essere utilizzato per determinare la portata o l’influenza di un utente X, quantificare la gamma di interessi dell’utente e il livello di coinvolgimento dell’utente su X. |
| receives_your_dm | boolean | Indica se questo utente riceverà o meno il DM dell’utente autenticato. | |
| subscription | object | Contiene dettagli su se l’utente è iscritto o meno all’utente autenticato. | |
| subscription_type | string | Una stringa che rappresenta il tipo di abbonamento X Premium dell’utente autenticato. Esempio: None, Basic, Premium,PremiumPlus. Restituirà sempre None se l’utente non è l’utente autenticato. | |
| url | string | L’URL specificato nel profilo dell’utente, se presente."url": "https://t.co/3ZX3TNiZCY" | Un URL fornito da un utente X nel proprio profilo. Potrebbe essere una homepage, ma non è sempre così. |
| verified | boolean | Indica se questo utente è un utente X verificato."verified": true | Indica se questo utente X ha un account verificato. Un account verificato fa sapere alle persone che un account di interesse pubblico è autentico. |
| verified_followers_count | string | Una stringa che rappresenta il numero di follower verificati di un utente. | |
| verified_type | string | Una stringa che rappresenta il tipo di verifica di un utente. Esempio: “blue”, “business”, “government” | |
| withheld | object | Contiene dettagli di sospensione per contenuto sospeso, se applicabile. |
$BEARER_TOKEN con il tuo Bearer Token generato.
Space
host_ids, creator_id, speaker_ids, mentioned_user_ids al parametro di query expansions.
A differenza dei Tweet, gli Spaces sono effimeri e diventano indisponibili dopo la loro conclusione o quando vengono annullati dal loro creatore. Quando la tua App gestisce i dati degli Spaces, sei responsabile di restituire le informazioni più aggiornate e devi rimuovere i dati che non sono più disponibili sulla piattaforma. Gli endpoint di lookup di Spaces possono aiutarti a garantire il rispetto delle aspettative e dell’intento degli utenti.
| Field Value | Type | Description | How it can be used |
|---|---|---|---|
| id (default) | string | L’identificatore univoco dello Space richiesto."id": "1zqKVXPQhvZJB" | Identificare in modo univoco uno Space restituito nella risposta. |
| state (default) | string | Indica se lo Space è iniziato, inizierà o è terminato."state": "live" | Filtrare gli Spaces live o programmati. |
| created_at | date (ISO 8601) | Ora di creazione di questo Space."created_at": "2021-07-04T23:12:08.000Z" | Capire quando è stato creato uno Space e ordinarli per data/ora. |
| creator_id | string | Identificatore univoco del creatore dello Space."creator_id": "2244994945" | |
| ended_at | date (ISO 8601) | Ora in cui lo Space è terminato, se applicabile."ended_at": "2021-07-04T00:11:44.000Z" | Determinare quando è terminato uno Space live ai fini della durata. |
| host_ids | array | Identificatori univoci degli host dello Space."host_ids": ["2244994945", "6253282"] | Espandere oggetti utente, comprendere il coinvolgimento. |
| lang | string | Lingua dello Space, se rilevata."lang": "en" | Classificare gli Spaces per lingua. |
| is_ticketed | boolean | Indica se si tratta di uno Space a pagamento (ticketed)."is_ticketed": false | Evidenziare contenuti di interesse. |
| invited_user_ids | array | Elenco di ID utente invitati come speaker."invited_user_ids": ["2244994945", "6253282"] | Espandere oggetti utente, comprendere il coinvolgimento. |
| participant_count | integer | Numero di utenti nello Space, inclusi host e speaker."participant_count": 420 | Comprendere il coinvolgimento, creare report. |
| subscriber_count | integer | Numero di persone che hanno impostato un promemoria per uno Space."subscriber_count": 36 | Comprendere l’interesse per l’evento. |
| scheduled_start | date (ISO 8601) | Ora di inizio programmata dello Space."scheduled_start": "2021-07-14T08:00:00.000Z" | Integrare con le notifiche del calendario. |
| speaker_ids | array | Elenco di utenti che hanno parlato in qualsiasi momento."speaker_ids": ["2244994945", "6253282"] | Espandere oggetti utente, comprendere il coinvolgimento. |
| started_at | date (ISO 8601) | Ora di avvio effettiva di uno Space."started_at": "2021-07-14T08:00:12.000Z" | Determinare l’ora di inizio dello Space. |
| title | string | Titolo dello Space."title": "Say hello to the Space data object!" | Comprendere parole chiave, hashtag, menzioni. |
| topic_ids | array | ID degli argomenti selezionati dal creatore dello Space."topic_ids": ["2244994945", "6253282"] | Comprendere parole chiave, hashtag, menzioni. |
| updated_at | date (ISO 8601) | Ultimo aggiornamento della metadata dello Space."updated_at": "2021-07-11T14:44:44.000Z" | Mantenere le informazioni aggiornate. |
$BEARER_TOKEN con il tuo Bearer Token generato.
List
list.fields.
L’oggetto List non è presente come figlio di altri oggetti data. Tuttavia, gli oggetti utente possono essere individuati ed espansi nella risorsa utente. Questi oggetti sono disponibili per l’espansione aggiungendo owner_id al parametro di query expansions. Utilizzare questa espansione insieme al parametro list.fields quando si richiedono campi aggiuntivi per completare l’oggetto List principale e user.fields per completare l’oggetto espanso.
| Field Value | Type | Description | How it can be used |
|---|---|---|---|
| id (default) | string | L’identificatore univoco di questa List."id": "2244994945" | Usalo per recuperare in modo programmatico informazioni su una specifica List. |
| name (default) | string | Il nome della List, come definito durante la creazione della List."name": "Twitter Lists" | |
| created_at | date (ISO 8601) | La data e ora UTC in cui la List è stata creata."created_at": "2013-12-14T04:35:55.000Z" | Determina da quanto tempo una List è su X. |
| description | string | Una breve descrizione per informare gli utenti sulla List."description": "People that are active members of the Bay area cycling community on Twitter." | |
| follower_count | integer | Indica quanti utenti seguono questa List."follower_count": 198 | |
| member_count | integer | Indica quanti membri fanno parte di questa List."member_count": 60 | |
| private | boolean | Indica se la List è privata."private": false | |
| owner_id | string | Identificatore univoco del proprietario di questa List."owner_id": "1255542774432063488" | Può essere utilizzato per verificare se questo utente possiede altre List ed espandere gli oggetti utente. |
$BEARER_TOKEN con il Bearer Token generato.
Media
?expansions=attachments.media_keys per ottenere l’oggetto ridotto con i soli campi predefiniti. Usa l’espansione insieme al parametro dei campi media.fields quando richiedi campi aggiuntivi per completare l’oggetto.
| Valore del campo | Tipo | Descrizione | Come può essere utilizzato |
|---|---|---|---|
| media_key (predefinito) | string | Identificatore univoco del contenuto multimediale espanso. "media_key": "13_1263145212760805376" | Può essere usato per recuperare i contenuti multimediali in modo programmatico |
| type (predefinito) | string | Tipo di contenuto (animated_gif, photo, video). "type": "video" | Classifica il contenuto come foto, GIF o video |
| url | string | URL diretto al file multimediale su X. | Restituisce un oggetto Media con un campo URL per le foto |
| duration_ms | integer | Disponibile quando type è video. Durata del video in millisecondi. "duration_ms": 46947 | |
| height | integer | Altezza di questo contenuto in pixel. "height": 1080 | |
| non_public_metrics | object | Metriche di coinvolgimento non pubbliche per il contenuto multimediale al momento della richiesta. Richiede autenticazione con contesto utente. "non_public_metrics": { "playback_0_count": 1561, "playback_100_count": 116, "playback_25_count": 559, "playback_50_count": 305, "playback_75_count": 183,} | Determina il coinvolgimento video: quanti utenti hanno riprodotto ciascun quarto del video. |
| organic_metrics | object | Metriche di coinvolgimento per il contenuto multimediale, tracciate in un contesto organico, al momento della richiesta. Richiede autenticazione con contesto utente. "organic_metrics": { "playback_0_count": 1561, "playback_100_count": 116, "playback_25_count": 559, "playback_50_count": 305, "playback_75_count": 183, "view_count": 629} | Determina il coinvolgimento organico dei contenuti multimediali. |
| preview_image_url | string | URL dell’anteprima statica segnaposto di questo contenuto. "preview_image_url": "https://pbs.twimg.com/media/EYeX7akWsAIP1_1.jpg" | |
| promoted_metrics | object | Metriche di coinvolgimento per il contenuto multimediale, tracciate in un contesto promozionale, al momento della richiesta. Richiede autenticazione con contesto utente. "promoted_metrics": { "playback_0_count": 259, "playback_100_count": 15, "playback_25_count": 113, "playback_50_count": 57, "playback_75_count": 25, "view_count": 124} | Determina il coinvolgimento dei contenuti quando il Tweet è stato promosso. |
| public_metrics | object | Metriche di coinvolgimento pubbliche per il contenuto multimediale al momento della richiesta. "public_metrics": { "view_count": 6865141} | Determina il numero totale di visualizzazioni del video allegato al Tweet. |
| width | integer | Larghezza di questo contenuto in pixel. "width": 1920 | |
| alt_text | string | Descrizione di un’immagine per abilitare e supportare l’accessibilità. Può contenere fino a 1000 caratteri. Al momento il testo alternativo può essere aggiunto solo alle immagini. "alt_text": "Rugged hills along the Na Pali coast on the island of Kauai" | Può essere usato per fornire una descrizione testuale di un’immagine nel caso in cui un utente abbia disabilità visive. |
| variants | array | Ogni oggetto multimediale può avere più varianti di visualizzazione o riproduzione, con diverse risoluzioni o formati. "variants": [{ "bit_rate": 632000, "content_type": "video/mp4", "url": "https://video.twimg.com/ext_tw_video/1527322141724532740/pu/vid/320x568/lnBaR2hCqE-R_90a.mp4?tag=12"}] |
attachment.media_keys. Assicurati di sostituire $BEARER_TOKEN con il tuo Bearer Token generato.
Sondaggio
?expansions=attachments.poll_ids per ottenere l’oggetto ridotto con soli campi predefiniti. Usa l’espansione insieme al parametro dei campi poll.fields quando richiedi campi aggiuntivi per completare l’oggetto.
| Valore del campo | Tipo | Descrizione |
|---|---|---|
| id (predefinito) | string | Identificatore univoco del sondaggio espanso. |
{"id": "1199786642791452673"} | ||
| options (predefinito) | array | Contiene oggetti che descrivono ciascuna opzione nel sondaggio di riferimento. |
{"options": [ { "position": 1, "label": "“C Sharp”", "votes": 795 }, { "position": 2, "label": "“C Hashtag”", "votes": 156 } ]} | ||
| duration_minutes | integer | Specifica la durata totale di questo sondaggio. |
{"duration_minutes": 1440} | ||
| end_datetime | date (ISO 8601) | Specifica la data e l’ora di fine di questo sondaggio. |
{"end_datetime": "2019-11-28T20:26:41.000Z"} | ||
| voting_status | string | Indica se questo sondaggio è ancora attivo e può ricevere voti oppure se la votazione è chiusa. |
{"voting_status": "closed"} |
attachments.poll_id. Assicurati di sostituire $BEARER_TOKEN con il tuo Bearer Token generato.
Luogo
?expansions=geo.place_id per ottenere l’oggetto ridotto con i soli campi predefiniti. Usa l’espansione insieme al parametro dei campi place.fields quando richiedi campi aggiuntivi per completare l’oggetto.
| Valore del campo | Tipo | Descrizione | Come può essere utilizzato |
|---|---|---|---|
| full_name (default) | string | Nome del luogo dettagliato in forma estesa. | Classificare un Tweet per un nome di luogo specifico |
"full_name": "Manhattan, NY" | |||
| id (default) | string | Identificatore univoco del luogo espanso, se si tratta di un punto di interesse taggato nel Tweet. | Usare per recuperare un luogo in modo programmatico |
"id": "01a9a39529b27f36" | |||
| contained_within | array | Restituisce gli identificatori dei luoghi noti che contengono il luogo di riferimento. | |
| country | string | Il nome esteso del paese a cui appartiene questo luogo. | Classificare un Tweet per nome del paese |
"country": "United States" | |||
| country_code | string | Il codice paese ISO Alpha-2 a cui appartiene questo luogo. | Classificare un Tweet per codice paese |
"country_code": "US" | |||
| geo | object | Contiene dettagli del luogo in formato GeoJSON. | |
| `json | |||
| ”geo”: | |||
| “type”: “Feature”, | |||
| “bbox”: [ | |||
| -74.026675, | |||
| 40.683935, | |||
| -73.910408, | |||
| 40.877483 | |||
| ], | |||
| “properties”: | |||
| } | |||
| ` | |||
| name | string | Il nome breve di questo luogo. | Classificare un Tweet per un nome di luogo specifico |
"name": "Manhattan" | |||
| place_type | string | Specifica il tipo di informazione rappresentata da questo luogo, ad esempio un nome di città o un punto di interesse. | Classificare un Tweet per un tipo specifico di luogo |
"place_type": "city" |
geo.place_id. Assicurati di sostituire $BEARER_TOKEN con il tuo Bearer Token generato.
Eventi dei Messaggi Diretti
- sender_id - L’ID dell’account che ha inviato il messaggio o che ha invitato un partecipante a una conversazione di gruppo
- participant_ids - Un array di ID account. Per gli eventi ParticipantsJoin e ParticipantsLeave questo array conterrà un singolo ID dell’account che ha creato l’evento
- attachments - Fornisce gli ID dei media per contenuti caricati su X dal mittente
- referenced_tweets - Se nel campo text è presente un URL di un Tweet, l’ID di quel Tweet è incluso nella risposta
| Valore del campo | Tipo | Descrizione | Come può essere utilizzato |
| id (default) | string | Identificatore univoco dell’evento. ”id”: “1050118621198921728” | Usalo per recuperare in modo programmatico uno specifico evento di conversazione (disponibile con gli endpoint v1.1). |
| event_type (default) | string | Descrive il tipo di evento. Attualmente sono supportati tre tipi: * MessageCreate * ParticipantsJoin * ParticipantsLeave “event_type”: “MessageCreate” | Durante il recupero della cronologia di una conversazione, per capire quando sono stati creati i messaggi e, per le conversazioni di gruppo, quando i partecipanti si sono uniti o hanno lasciato. Tutti i metodi GET supportano il filtraggio di tipi di evento specifici con il parametro di query event_type=. |
| text (default) | string | Testo effettivo UTF-8 del Messaggio Diretto. ”text”: “Hello, just you!” | Con i chatbot, può essere usato per analizzare il contenuto dei messaggi e determinare risposte automatiche. Può essere usato per creare funzionalità di ricerca nelle conversazioni. |
| entities | object | Entità estratte dal testo del DM. | Fornisce informazioni aggiuntive su hashtag, URL, menzioni, ecc. |
| sender_id | string | ID dell’Utente che crea l’evento. Per espandere questo oggetto nella risposta, includi sender_id come espansione e usa il parametro di query user.fields per specificare gli attributi dell’oggetto utente di interesse. ”sender_id”: “906948460078698496” | Recupera l’oggetto utente che ha creato l’evento MessageCreate o ParticipantsJoin. |
| participant_ids | array (of strings) | ID dei partecipanti che si uniscono o lasciano una conversazione di gruppo. Usato anche quando si creano nuove conversazioni di gruppo. Per espandere questo oggetto nella risposta, includi participant_ids come espansione e usa il parametro di query user.fields per specificare gli attributi dell’oggetto utente di interesse. ”participant_ids”: [ “906948460078698496” ] | Usato per recuperare gli oggetti utente dei partecipanti che si uniscono o lasciano conversazioni di gruppo. |
| dm_conversation_id | string | Identificatore univoco della conversazione di cui l’evento fa parte. ”dm_conversation_id”: “1584988213961031680” | Usalo per recuperare in modo programmatico eventi da una conversazione e aggiungervi Messaggi Diretti. |
| created_at | date (ISO 8601) | Ora di creazione (UTC) del Tweet. ”created_at”: “2019-06-04T23:12:08.000Z” | Questo campo può essere usato per capire quando è stato creato un Messaggio Diretto o quando i partecipanti alla conversazione si sono uniti o hanno lasciato. |
| referenced_tweets | array | ID di qualsiasi Tweet menzionato nel testo del Messaggio Diretto. Per espandere questo oggetto nella risposta, includi referenced_tweets.id come espansione e usa il parametro di query tweet.fields per specificare gli attributi dell’oggetto Tweet di interesse. ”referenced_tweets”: [ “id”: “1578868150510456833” ] | Quando i Messaggi Diretti fanno riferimento a un Tweet, questi ID possono essere usati per cercare i dettagli del Tweet. |
| attachments | object | Per i Messaggi Diretti con media allegati, fornisce la media key del contenuto caricato (foto, video o GIF). Per espandere questo oggetto nella risposta, includi attachments.media_keys come espansione e usa il parametro di query media.fields per specificare gli attributi dell’oggetto media di interesse. Attualmente è supportato un solo allegato. “attachments”: “media_keys”: [ “3_1136048009270239232” ] | Per comprendere gli oggetti media allegati ai Messaggi Diretti. |
- Attributi fondamentali dell’evento, come quando è stato creato e a quale conversazione appartiene (dm_conversation).
- L’ID dell’account e la descrizione di chi ha inviato il Messaggio Diretto.
- Il testo di qualsiasi Tweet di riferimento e quando è stato pubblicato.
- L’ID dell’account e la descrizione di qualsiasi autore del Tweet di riferimento.
?dm_event.fields=id,sender_id,text,created_at,dm_conversation_id&expansions=sender_id,referenced_tweets.id&tweet.fields=created_at,text,author_id&user.fields=description
Community
| Field value | Type | Description | |
|---|---|---|---|
| created_at | date (ISO 8601) | Ora di creazione della Community. | |
| id | string | L’identificatore univoco della Community. | |
| name | string | Il nome della Community. | |
| description | string | Il testo della descrizione della Community, se presente. | |
| access | string | Il livello di accesso della Community. Può essere uno dei seguenti: | |
- Public | |||
- Closed | |||
| join_policy | string | La policy di adesione della Community. Può essere una delle seguenti: | |
- Open | |||
- RestrictedJoinRequestsDisabled | |||
- RestrictedJoinRequestsRequireAdminApproval | |||
- RestrictedJoinRequestsRequireModeratorApproval | |||
- SuperFollowRequired | |||
| member_count | integer | Il numero di membri che hanno aderito alla Community. |
$BEARER_TOKEN con il tuo Bearer Token generato.
Come utilizzare fields ed expansions
fields ed expansions nella richiesta per ricevere oggetti e campi aggiuntivi nella risposta.
In questa guida richiederemo diversi campi nell’istantanea del seguente Tweet.
Richiesta di fields e oggetti aggiuntivi.
- Individua i campi aggiuntivi che desideri richiedere utilizzando il nostro object model oppure consultando l’elenco dei campi nelle pagine di riferimento dell’API degli endpoint. In questo caso, richiederemo i seguenti fields aggiuntivi: attachments, author_id, created_at, public_metrics.
-
Costruisci il parametro di query
tweet.fieldsimpostando come valore i campi sopra, separati da virgole:?tweet.fields=attachments,author_id,created_at,public_metrics - Aggiungi il parametro query alla richiesta GET /tweets che hai eseguito in precedenza.
curl --request GET --url 'https://api.x.com/2/tweets?ids=1260294888811347969&tweet.fields=attachments,author_id,created_at,public_metrics' \ --header 'Authorization: Bearer $BEARER_TOKEN'
Risposta:
- Successivamente, richiederemo i campi relativi al video che è stato incluso nel Tweet. Per farlo, utilizzeremo il parametro
expansionsconattachments.media_keyscome valore, e lo aggiungeremo alla richiesta.
- Infine, richiederemo il conteggio delle visualizzazioni e la durata del video. Questi non sono campi predefiniti, quindi dobbiamo richiederli esplicitamente. Utilizza il parametro
media.fieldscon i valori separati da virgolapublic_metricseduration_msnella tua richiesta.
curl --request GET --url 'https://api.x.com/2/tweets?ids=1260294888811347969&tweet.fields=attachments,author_id,created_at,public_metrics&expansions=attachments.media_keys&media.fields=duration_ms,public_metrics' --header 'Authorization: Bearer $BEARER_TOKEN'
Risposta, che ora include tutti i dati visibili nello screenshot del Tweet:
- ids=1260294888811347969
- tweet.fields=attachments,author_id,created_at,public_metrics
- expansions=attachments.media_keys
- media.fields=public_metrics,duration_ms