Confronto tra gli endpoint dei conteggi dei Post della X API
L’endpoint dei conteggi dei Post della v2 alla fine sostituirà l’endpoint dei conteggi della Search API Enterprise. Se disponi di codice, App o strumenti che utilizzano una versione precedente di un endpoint dei conteggi dei Post e stai valutando la migrazione ai nuovi endpoint della X API v2, questa guida fa per te. Questa pagina contiene due tabelle di confronto:- Conteggi dei Post recenti
- Conteggi dei Post dell’archivio completo
- Confronto degli operatori di filtro
Confronto dei conteggi dei Post recenti
La versione Enterprise degli endpoint per i conteggi dei Post consente di ottenere i conteggi per 30 giorni oppure dall’intero archivio. Pertanto, l’endpoint v2 per i conteggi dei Post recenti, che considera un periodo di 7 giorni, non è un sostituto diretto di nessuno dei suddetti endpoint. Tuttavia, per facilitare i confronti, esamineremo come l’endpoint v2 per i conteggi dei Post recenti si confronta con l’endpoint Enterprise di 30 giorni. La seguente tabella confronta i vari tipi di endpoint per i conteggi dei Post recenti:| Descrizione | Enterprise | X API v2 |
|---|---|---|
| Dominio host | https://gnip-api.x.com | https://api.x.com |
| Percorso endpoint | /search/30day/accounts/:account_name/:label/counts.json | /2/tweets/counts/recent |
| Autenticazione | Basic authentication | OAuth 2.0 Bearer Token |
| Formato timestamp | YYYYMMDDhhmm | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Restituisce conteggi di Post non più vecchi di | 31 giorni | 7 giorni |
| Metodi HTTP supportati | GET | GET |
| Limiti di velocità predefiniti per le richieste | 20 richieste per 1 sec, aggregato tra richieste di dati di ricerca e richieste di conteggi Il limite di velocità per minuto varia in base al partner, come specificato nel contratto. | 180 richieste per 15 min per utente 450 richieste per 15 min per App |
| Supporta il filtraggio usando le annotations | ✔ | |
| Supporta il filtraggio usando conversation_id | ✔ | |
| Nome della chiave JSON per l’array di Post | results | data |
| Granularità temporale | Giorno, ora o minuto | Giorno, ora o minuto |
| Fuso orario | UTC | UTC |
| Parametri di richiesta per selezionare il periodo di tempo | fromDate toDate | start_time end_time |
| Parametri di richiesta per navigare tramite ID del Post | since_id until_id | |
| Richiede l’uso di credenziali di una developer App associata a un project | ✔ |
Confronto dei conteggi di Post dell’intero archivio
La tabella seguente confronta i vari tipi di endpoint di ricerca sull’intero archivio:| Descrizione | Enterprise | X API v2 |
|---|---|---|
| Dominio host | https://gnip-api.x.com | https://api.x.com |
| Percorso endpoint | /search/fullarchive/accounts/:account_name/:label/counts | /2/tweets/counts/all |
| Authentication | Basic auth | OAuth 2.0 Bearer Token |
| Formato timestamp | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| Restituisce conteggi di Post non più vecchi di | L’intero archivio a partire da marzo 2006 | L’intero archivio a partire da marzo 2006 |
| Metodi HTTP supportati | GET POST | GET |
| Limiti di velocità predefiniti per le richieste | Il limite di velocità al minuto varia in base al partner, come specificato nel contratto. 20 richieste al secondo | 300 richieste per 15 min per App 1 richiesta per 1 sec per App |
| Granularità | Giorno, ora, minuto | Giorno, ora, minuto |
| Supporta il filtraggio usando le annotations | ✔ | |
| Supporta il filtraggio usando conversation_id | ✔ | |
| Nome della chiave JSON per l’array di Post data | results | data |
| Parametri di richiesta per selezionare l’intervallo temporale | fromDate toDate | start_time end_time |
| Parametri di richiesta per navigare per ID del Post | since_id until_id | |
| Nome della chiave JSON per la paginazione | next | meta.next_token |
| Parametro di richiesta per la paginazione | next_token | next_token o pagination_token |
| Fuso orario | UTC | UTC |
| Richiede l’uso di credenziali di una developer App associata a un Project con Academic Research access | ✔ |
Confronto degli operatori di filtro
Le due versioni (Enterprise e v2) dei conteggi dei Post differiscono per gli operatori disponibili e presentano anche livelli diversi di disponibilità degli operatori all’interno di ciascuna versione, come spiegato di seguito. Enterprise- Non esistono sottolivelli di operatori Enterprise. Tutti gli operatori Enterprise sono disponibili per tutti gli utenti Enterprise.
- Core: Questi operatori sono disponibili per qualsiasi utente v2.
- Advanced: Questi operatori sono disponibili solo per gli utenti approvati per l’accesso Academic Research.
| Enterprise | v2 | |
|---|---|---|
| keyword | Available | Core |
| emoji | Available | Core |
| “exact phrase” | Available | Core |
| # | Available | Core |
| $ | Available | Advanced |
| @ | Available | Core |
| from: | Available | Core |
| to: | Available | Core |
| url: | Available | Core |
| retweets_of: | Available | Core |
| context: | Core | |
| entity: | Core - Only available with recent search | |
| conversation_id: | Core | |
| place: | Available | Advanced |
| place_country: | Available | Advanced |
| point_radius: | Available | Advanced |
| bounding_box: | Available | Advanced |
| is:retweet | Available | Core |
| is:reply | Available | Core |
| is:quote | Available | Core |
| is:verified | Available | Core |
| -is:nullcast | Available | Advanced |
| has:hashtags | Available | Core |
| has:cashtags | Available | Advanced |
| has:links | Available | Core |
| has:mentions | Available | Core |
| has:media | Available | Core |
| has:images | Available | Core |
| has:videos | Available | Core |
| has:geo | Available | Advanced |
| lang: | Available | Core |
| list: | Advanced | |
| has:profile_geo | Available | |
| profile_country | Available | |
| profile_locality | Available | |
| profile_region | Available | |
| proximity | Available |