Cerca Post (archivio completo)

​

Introduzione all’endpoint full-archive Post counts    

Questa guida di Avvio rapido ti aiuterà a inviare la tua prima richiesta all’endpoint full-archive Post counts utilizzando Postman, uno strumento grafico che consente di effettuare richieste HTTP.

Se desideri consultare esempi di codice in diversi linguaggi di programmazione, visita il nostro repository GitHub X API v2 sample code. 

​

Prerequisiti

L’endpoint full-archive Post counts è attualmente disponibile solo per chi dispone di accesso Pro o Enterprise. Per utilizzare questo endpoint, devi richiedere l’accesso Pro o l’Enterprise access. 

Oltre all’approvazione dell’accesso, avrai bisogno di un set di chiavi e token per autenticare la tua richiesta. Puoi generare queste chiavi e questi token seguendo questi passaggi:

• Vai al tuo Project con accesso Enterprise nel developer portal e assicurati di avere un’App sviluppatore associata all’interno di quel Project.

• Vai alla pagina “Keys and tokens” della tua App per generare le credenziali necessarie. Assicurati di salvare tutte le credenziali in un luogo sicuro.

​

Passaggi per creare una richiesta di conteggio dei Post sull’intero archivio

Primo passaggio: iniziare 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 nel tuo ambiente la raccolta Postman di X API v2, fai clic sul seguente pulsante:

Aggiungi X API v2 a Postman

Una volta caricata la raccolta X API v2 in Postman, vai a Post counts > Full-archive Post counts request.

Secondo passaggio: autentica la 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 i metodi di autenticazione OAuth 2.0 App-Only.

Devi aggiungere le tue chiavi e token, in particolare l’App Access Token (noto anche come App-only Bearer Token) in 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 nei 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 inserita nella scheda Authorization della richiesta se hai eseguito correttamente questa operazione.  

Terzo passaggio: crea una query

Ogni richiesta di conteggio dei Post sull’intero archivio richiede una singola query. In questo esempio useremo una query che seleziona i Post pubblicati dall’account @XDevelopers. Per questa query utilizziamo l’operatore from e lo impostiamo su XDevelopers (non sensibile alle maiuscole):

from:XDevelopers

In Postman, vai alla scheda “Params” e inserisci questo ID, o una stringa di ID di Post separati da virgola, nella colonna “Value” del parametro ids.  

Key	Value	Description
query	from:XDevelopers	Query da inviare all’endpoint di conteggio dei Post sull’intero archivio

Quarto passaggio (opzionale): specifica la granularità e l’intervallo temporale

Se fai clic sul pulsante “Send” dopo il terzo passaggio, otterrai il conteggio predefinito dei Post sull’intero archivio: per ora negli ultimi 30 giorni. Se vuoi ottenere i conteggi per giorno, dovrai aggiungere il parametro granularity con valore day. Se vuoi i conteggi dei Post per un periodo precedente a 30 giorni fa, dovrai specificare i parametri start_time ed end_time con i valori desiderati. 

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

Key	Value	Description
granularity	day	La granularità dei risultati del conteggio dei Post. Valori possibili: day, hour o minute
start_time	2021-05-01T00:00:00Z	Il timestamp UTC meno recente da cui verranno restituiti i Post
end_time	2021-06-01T00:00:00Z	Il timestamp UTC più recente fino al quale verranno restituiti i Post.

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

https://api.x.com/2/tweets/counts/all?query=from%3AXDevelopers&start_time=2021-05-01T00:00:00Z&end_time=2021-06-01T00:00:00Z&granularity=day

Quinto passaggio: invia la richiesta e verifica la risposta

Una volta configurato tutto, fai clic sul pulsante “Send” e riceverai una risposta simile alla seguente:

{
   "data": [
       {
           "end": "2021-05-02T00:00:00.000Z",
           "start": "2021-05-01T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-03T00:00:00.000Z",
           "start": "2021-05-02T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-04T00:00:00.000Z",
           "start": "2021-05-03T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-05T00:00:00.000Z",
           "start": "2021-05-04T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-06T00:00:00.000Z",
           "start": "2021-05-05T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-07T00:00:00.000Z",
           "start": "2021-05-06T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-08T00:00:00.000Z",
           "start": "2021-05-07T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-09T00:00:00.000Z",
           "start": "2021-05-08T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-10T00:00:00.000Z",
           "start": "2021-05-09T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-11T00:00:00.000Z",
           "start": "2021-05-10T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-12T00:00:00.000Z",
           "start": "2021-05-11T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-13T00:00:00.000Z",
           "start": "2021-05-12T00:00:00.000Z",
           "tweet_count": 6
       },
       {
           "end": "2021-05-14T00:00:00.000Z",
           "start": "2021-05-13T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-15T00:00:00.000Z",
           "start": "2021-05-14T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-16T00:00:00.000Z",
           "start": "2021-05-15T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-17T00:00:00.000Z",
           "start": "2021-05-16T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-18T00:00:00.000Z",
           "start": "2021-05-17T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-19T00:00:00.000Z",
           "start": "2021-05-18T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-20T00:00:00.000Z",
           "start": "2021-05-19T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-21T00:00:00.000Z",
           "start": "2021-05-20T00:00:00.000Z",
           "tweet_count": 8
       },
       {
           "end": "2021-05-22T00:00:00.000Z",
           "start": "2021-05-21T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-23T00:00:00.000Z",
           "start": "2021-05-22T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-24T00:00:00.000Z",
           "start": "2021-05-23T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-25T00:00:00.000Z",
           "start": "2021-05-24T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-26T00:00:00.000Z",
           "start": "2021-05-25T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-27T00:00:00.000Z",
           "start": "2021-05-26T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-28T00:00:00.000Z",
           "start": "2021-05-27T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-29T00:00:00.000Z",
           "start": "2021-05-28T00:00:00.000Z",
           "tweet_count": 2
       },
       {
           "end": "2021-05-30T00:00:00.000Z",
           "start": "2021-05-29T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-31T00:00:00.000Z",
           "start": "2021-05-30T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-01T00:00:00.000Z",
           "start": "2021-05-31T00:00:00.000Z",
           "tweet_count": 0
       }
   ],
   "meta": {
       "total_tweet_count": 22
   }
}

Passaggio sei: esegui la paginazione dei risultati

Se l’oggetto “meta” nella tua risposta contiene anche next_token, puoi passare il suo valore al parametro di query next_token.

Key	Value	Description
next_token	Aggiungi qui il next_token che recuperi dall’oggetto meta della tua richiesta precedente.	Se l’ultima richiesta non restituisce tutti i risultati rimanenti, riceverai un next_token nell’oggetto meta. Recupera il valore di quel campo e inseriscilo come valore del parametro next_token nella richiesta successiva, mantenendo invariati tutti gli altri parametri della richiesta.

Una volta impostato il valore corretto per next_token, fai clic sul pulsante “Send” per ricevere la pagina successiva dei risultati.