Guida rapida

​

Introduzione all’endpoint di ricerca dei Quote Tweets

Questa guida di Avvio rapido ti aiuterà a inviare la tua prima richiesta agli endpoint di ricerca dei Quote Tweets con un set di fields specificati usando Postman.

Se desideri vedere esempi di codice in diverse lingue, visita il nostro repository GitHub X API v2 sample code. 

​

Prerequisites

Per completare questa guida, avrai bisogno di un set di chiavi e token per autenticare la tua richiesta. Puoi generarli seguendo questi passaggi:

• Registrati per un account sviluppatore e ottieni l’approvazione.
• Crea un Project e una developer App associata nel developer portal.
• Vai alla pagina “Keys and tokens” della tua App per generare le credenziali richieste. Assicurati di salvare tutte le credenziali in un luogo sicuro.

Passaggi per creare una richiesta di lookup delle Quote Tweets

Primo passaggio: inizia con uno strumento o una libreria

Esistono diversi strumenti, esempi di codice e librerie che puoi utilizzare per effettuare una richiesta a questo endpoint, ma qui useremo Postman per semplificare il processo.

Per caricare la collection Postman di X API v2 nel tuo ambiente, fai clic sul seguente pulsante:

Aggiungi X API v2 a Postman

Una volta caricata la collection X API v2 in Postman, vai alla cartella timeline e trova la richiesta “Quote Tweets by ID”.

Secondo passaggio: autentica la tua richiesta

Per effettuare correttamente una richiesta alla X API, devi verificare di avere l’autorizzazione. Per farlo con questo endpoint, devi autenticare la richiesta con uno dei seguenti metodi: OAuth 2.0 App-Only, OAuth 2.0 Authorization Code con PKCE o Contesto utente OAuth 1.0a.

Per semplicità, utilizzeremo OAuth 2.0 App-Only con questa richiesta, ma dovrai usare uno degli altri metodi di autenticazione se desideri richiedere metriche o Post privati.

Devi aggiungere le tue chiavi e token, in particolare l’App Access Token (noto anche come App-only Bearer Token) a Postman. Puoi farlo selezionando l’ambiente denominato “X API v2” nell’angolo in alto a destra di Postman e aggiungendo le tue chiavi e token ai campi “initial value” e “current value” (facendo clic sull’icona a forma di occhio accanto al menu a discesa dell’ambiente).

Questa variabile verrà automaticamente utilizzata nella scheda “Authorization” della richiesta se hai eseguito correttamente i passaggi.

Terzo passaggio: identifica e specifica il Post per cui desideri recuperare le Quote Tweets

Devi specificare un Post per cui desideri recuperare le Quote Tweets all’interno della richiesta passando l’ID del Post.

In questo esempio, l’ID del Post che utilizzeremo è 1409931481552543749.

In Postman, vai alla scheda “Params” e inserisci questo ID del Post nella colonna “Value” del parametro id.

Key	Value
id	1409931481552543749

Quarto passaggio: identifica e specifica quali fields desideri recuperare

Se fai clic sul pulsante “Send” dopo il terzo passaggio, riceverai i fields predefiniti dell’Oggetto Post nella risposta: id, text ed edit_history_tweet_ids.

Se desideri ricevere fields aggiuntivi, dovrai specificarli nella richiesta con i parametri fields e/o expansions.

Per questo esercizio, richiederemo tre set aggiuntivi di fields da oggetti differenti:

1. Il field aggiuntivo tweet.created_at negli oggetti utente primari.
2. I fields predefiniti dell’oggetto utente degli autori associati per i Post restituiti: id, name e username
3. Il field aggiuntivo user.created_at negli oggetti utente associati.

In Postman, vai alla scheda “Params” e aggiungi la seguente coppia chiave:valore alla tabella “Query Params”:

Chiave	Valore	Campi restituiti
tweet.fields	created_at	tweets.created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Ora dovresti vedere il seguente URL accanto al pulsante “Send”:

https://api.x.com/2/tweets/:id/quote_tweets?expansions=author_id&tweet.fields=created_at&user.fields=created_at

Nota bene:

In Postman, il parametro di percorso :id nel campo URL non si aggiorna automaticamente al valore che inserisci nel campo dei parametri id; per questo motivo l’URL sopra include :id e non 1409931481552543749.

Passaggio cinque: invia la richiesta e verifica la risposta

Una volta configurato tutto, premi il pulsante “Send” e riceverai la seguente risposta:

{
 "data": [
   {
     "created_at": "2022-02-22T04:31:34.000Z",
     "text": "RT @chris_bail: X ha creato un corso completo (con video, codice e altri materiali) per aiutare i ricercatori a imparare come raccogliere dati…",
     "author_id": "29757971",
     "id": "1495979553889697792"
   },
   {
     "created_at": "2022-01-26T17:07:43.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "241588187",
     "id": "1486385372401737728"
   },
   {
     "created_at": "2022-01-11T17:28:04.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "24961055",
     "id": "1480954678447857669"
   },
   {
     "created_at": "2022-01-10T20:34:46.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "1441574419789324291",
     "id": "1480639272721940486"
   },
   {
     "created_at": "2021-12-16T22:55:24.000Z",
     "text": "RT @chris_bail: X ha creato un corso completo (con video, codice e altri materiali) per aiutare i ricercatori a imparare come raccogliere dati…",
     "author_id": "1623598771",
     "id": "1471614967207976961"
   },
   {
     "created_at": "2021-12-13T15:59:55.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "1506401233",
     "id": "1470423243513372679"
   },
   {
     "created_at": "2021-12-10T02:02:45.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "40103034",
     "id": "1469125403373568001"
   },
   {
     "created_at": "2021-12-08T17:27:54.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "1436400156006567936",
     "id": "1468633446935318529"
   },
   {
     "created_at": "2021-09-15T21:40:24.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "81650379",
     "id": "1438256410417143809"
   },
   {
     "created_at": "2021-08-26T16:45:16.000Z",
     "text": "RT @suhemparack: Entusiasta di condividere il nostro corso su Come iniziare con le API di #X v2 per la ricerca accademica\n\nSe conosci studenti…",
     "author_id": "40462535",
     "id": "1430934381829492746"
   }
 ],
 "includes": {
   "users": [
     {
       "username": "j_a_tucker",
       "id": "29757971",
       "name": "Joshua Tucker",
       "created_at": "2009-04-08T16:45:38.000Z"
     },
     {
       "username": "whimchic",
       "id": "241588187",
       "name": "whimchic",
       "created_at": "2011-01-22T16:51:43.000Z"
     },
     {
       "username": "mattbiehl",
       "id": "24961055",
       "name": "Matthias Biehl",
       "created_at": "2009-03-17T21:41:27.000Z"
     },
     {
       "username": "weixinac",
       "id": "1441574419789324291",
       "name": "J",
       "created_at": "2021-09-25T01:25:19.000Z"
     },
     {
       "username": "RSangeleer",
       "id": "1623598771",
       "name": "Richard Sangeleer",
       "created_at": "2013-07-26T18:25:45.000Z"
     },
     {
       "username": "Gulnerman",
       "id": "1506401233",
       "name": "Giz Gulnerman",
       "created_at": "2013-06-11T20:13:40.000Z"
     },
     {
       "username": "efishman123",
       "id": "40103034",
       "name": "Elishema Fishman",
       "created_at": "2009-05-14T22:25:58.000Z"
     },
     {
       "username": "dtcxwz",
       "id": "1436400156006567936",
       "name": "Hüseyin Ateş",
       "created_at": "2021-09-10T18:44:30.000Z"
     },
     {
       "username": "brendaberkelaar",
       "id": "81650379",
       "name": "Dr. Brenda Berkelaar",
       "created_at": "2009-10-11T18:09:16.000Z"
     },
     {
       "username": "misoca",
       "id": "40462535",
       "name": "Michael Soto",
       "created_at": "2009-05-16T13:26:05.000Z"
     }
   ]
 },
 "meta": {
   "result_count": 10,
   "next_token": "avdjwk0udyx6"
 }
}

​

Passaggio sei: Paginare i risultati

Nella risposta precedente troverai, in fondo, un oggetto meta che include i seguenti fields:

• results_count
• next_token

Nel passaggio quattro, poiché non abbiamo specificato il parametro max_results, per impostazione predefinita otterremo solo 10 Post. Per accedere alle pagine aggiuntive di data, prenderemo il valore del campo next_token dagli ultimi risultati e aggiungeremo tale stringa come valore del parametro pagination_token nella pagina dei parametri di Postman, mantenendo tutto il resto invariato. 

Chiave	Valore
pagination_token	avdjwk0udyx6

Una volta configurato tutto, puoi fare clic su “Send” di nuovo e dovresti ricevere la pagina successiva dei risultati. 

Abbiamo preparato una guida sulla paginazione per approfondire questo concetto.