Vai al contenuto principale

​
Introduzione

Sebbene il recent search endpoint consenta di ottenere solo i Post pubblicati negli ultimi 7 giorni, gli endpoint della timeline dei Post dell’utente e della timeline delle menzioni dell’utente consentono di recuperare Post e menzioni più vecchi dei 7 giorni precedenti, per un utente autorizzato (utilizzando l’id utente). Gli sviluppatori possono usare questi endpoint per analizzare argomenti, entità e il sentiment dei Post dalla timeline di un utente o dalle sue menzioni. In questo tutorial mostreremo come esplorare i Post e le menzioni di un utente utilizzando gli endpoint della timeline dei Post dell’utente e della timeline delle menzioni dell’utente.  

​
Prerequisiti

  • Per utilizzare gli endpoint della timeline dei Tweet dell’utente e delle menzioni dell’utente, è necessario disporre di un account sviluppatore valido.
  • È inoltre necessario avere un Project creato.
  • Devi esserti registrato per un account sviluppatore e aver attivato la nuova esperienza del developer portal.
  • L’accesso è disponibile con chiavi e token attivi per un’App sviluppatore collegata a un Project creato nel developer portal.
  • Un Bearer Token dalla tua App nel developer portal di X.
  • Se non disponi di un account sviluppatore approvato, puoi presentare domanda.

​
Account sviluppatore approvato

Se non ne hai ancora uno, puoi inoltrare una richiesta.

​
Crea un Project e collega un’App

Nel developer portal, fai clic per creare un nuovo Project.
Assegna un nome, seleziona il caso d’uso appropriato e fornisci una descrizione del Project. Successivamente, puoi creare una nuova App oppure collegare un’App esistente (un’App è un contenitore per le tue API Key necessarie per effettuare una richiesta HTTP alla X API).
Fai clic su “create a new App instead” e assegna un nome alla tua App per crearne una nuova.
Una volta fatto clic su Complete, otterrai le tue API Key e il Bearer Token che potrai utilizzare per connetterti ai nuovi endpoint della X API v2.
Fai clic sul (+) accanto a API Key, API Secret Key e Bearer Token e copia questi valori in un luogo sicuro sulla tua macchina locale. Ti serviranno per effettuare le chiamate API nel passaggio successivo. Nota: le chiavi nello screenshot sopra sono nascoste, ma nel tuo developer portal potrai vedere i valori effettivi per API Key, API Secret Key e Bearer Token.  

​
Come ottenere l’id utente per un account da utilizzare negli endpoint della timeline dei Tweet dell’utente e della timeline delle menzioni dell’utente

Gli endpoint della timeline dei Tweet dell’utente e della timeline delle menzioni dell’utente consentono di ottenere Post utilizzando l’id utente. Per ricavare l’id utente da un nome utente, puoi usare il nuovo endpoint di lookup utente v2. Sostituisci USER_NAME con il nome utente desiderato e XXXX con il tuo Bearer Token ottenuto sopra 
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
Vedrai l’id dell’utente nella risposta, come mostrato di seguito: 
{
   "data": {
       "id": "2244994945",
       "name": "Sviluppatori",
       "username": "XDevelopers"
   }
}

​
Connessione agli endpoint della timeline dei Tweet dell’utente e della timeline delle menzioni dell’utente

Per ottenere la timeline dei Tweet di un utente, esegui il seguente comando curl nel terminale (assicurati di sostituire USER_ID con l’id dell’utente desiderato e XXXX con il tuo Bearer Token ottenuto sopra) 
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
Noterai che la risposta JSON per queste richieste contiene, per impostazione predefinita, l’id e il testo dei Post (vedi esempio sotto). 
{
   "id": "1334200897081987072",
   "text": "👀 Se non conosci ancora le X API v2, consulta questa guida passo-passo per effettuare la tua prima richiesta https://t.co/4rZqThpSbp"
}
Se desideri che nella risposta vengano restituiti campi aggiuntivi (ad esempio informazioni sull’utente o ulteriori campi del Tweet come le annotations di contesto), devi specificare esplicitamente tali fields nella richiesta. Scopri come farlo nella guida sull’uso di fields ed expansions. Puoi anche ottenere questi Post usando il linguaggio di programmazione che preferisci. Consulta i nostri esempi di codice in Python, Node (JavaScript), Java e Ruby per gli endpoint della timeline dei Tweet dell’utente e della timeline delle menzioni dell’utente nel nostro repository GitHub.

​
Esplorare i Post dell’utente

Una volta che sai come ottenere i Post utilizzando gli endpoint della timeline dei Tweet dell’utente e della timeline delle menzioni dell’utente, puoi iniziare a esplorarne i Post. Ad esempio, se vuoi identificare le entità denominate più ricorrenti presenti nelle menzioni di un utente, puoi procedere così: Nella richiesta all’API, specifica che desideri che l’oggetto context_annotations venga restituito nelle risposte dei Tweet: 
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
Nella risposta potrai vedere se nelle menzioni sono presenti entità denominate. Ecco un esempio: 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Brand e Aziende"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
Se vuoi vedere quali entità popolari compaiono nelle tue menzioni, puoi mantenere un conteggio delle entità popolari analizzando ogni Tweet nelle menzioni. Se vuoi esplorare l’URL dell’immagine di anteprima per tutti i Post nella tua timeline che contengono contenuti multimediali, puoi procedere così: Nella richiesta API, specifica che desideri preview_image_url nei tweet.media fields e attachments.media_keys expansions 
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
Nella risposta, vedrai il campo preview_image_url all’interno dell’oggetto includes, come mostrato di seguito: 
{
   "includes": {
       "media": [
           {
               "media_key": "16_1334657439640121344",
               "preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
               "type": "animated_gif"
           }
       ]
   }
}
Una volta compreso come esplorare i Post di un utente, puoi utilizzare altre API e servizi per ottenere di più dai Post. Di seguito trovi alcune risorse utili quando si utilizzano gli endpoint della timeline dei Tweet dell’utente e delle menzioni dell’utente.

​
Risorse

⌘I