Twitter API

API Twitter: ricerca utenti, cronologie e paginazione

Integra gli endpoint Twitter / X di API Hop con autenticazione Bearer, selezione dei campi utente e tweet, paginazione a cursore e gestione degli errori di validazione.

Risolvi un nome utente in ID, recupera la cronologia e passa il token successivo per un’altra pagina. Le chiamate riuscite restituiscono JSON direttamente; questi endpoint non richiedono polling Jobs.

Ottieni una chiave API Esplora il catalogo API

Per un’attività specifica

Implementa le tre operazioni GET supportate e gestisci i risultati.

Trova un account per nome utente e seleziona i campi del profilo da restituire.

Aggiorna un account noto per ID senza cercare di nuovo il nome utente.

Recupera pagine della cronologia con limite di dimensione e token di paginazione.

Unità di fatturazione

Come viene misurato l’utilizzo

USD per richiesta.

Limiti operativi

I campi restituiti dipendono dai parametri documentati e dalla risposta a monte.
max_results deve essere un intero da 1 a 100. Una pagina può contenere meno risultati.
Conserva gli ID utente e tweet come stringhe per evitare perdite di precisione numerica.

Guide di integrazione

Scegli il prossimo passo

Pianifica aggiornamenti e archiviazione Limita le richieste, deduplica i post e registra gli orari di recupero nell’applicazione. Catalogo API di dati Esamina prodotti di dati, operazioni e prezzi per richiesta attuali.

Copertura attuale del catalogo

API disponibili e unità di fatturazione

Confronta ID API, operazioni, fornitori e prezzi. Controlla la data del catalogo e l’unità di fatturazione di ogni operazione prima di stimare i costi.

API di dati

Twitter User Data

twitter-user-data Documentazione

Disponibile

Recupera i profili pubblici degli utenti Twitter / X e le loro cronologie.

Fornitore: Twitter / X Data
Unità di fatturazione: richiesta
Formati API ed endpoint: Consulta le operazioni seguenti per gli endpoint.
Funzionalità pubblicate: Ricerca utente, Cronologia utente

Operazioni pubblicate

GET /v1/twitter/users Recupera utente per nome utente
GET /v1/twitter/users/{id} Recupera utente per ID
GET /v1/twitter/users/{id}/tweets Recupera i tweet dell’utente

Prezzo API Hop

Richiesta: $0.0020 /richiesta

Recupera utente per nome utente

GET /v1/twitter/users

Prezzo API Hop

Richiesta: $0.0020 /richiesta

Recupera utente per ID

GET /v1/twitter/users/{id}

Prezzo API Hop

Richiesta: $0.0020 /richiesta

Recupera i tweet dell’utente

GET /v1/twitter/users/{id}/tweets

Prezzo API Hop

Richiesta: $0.0020 /richiesta

Apri il catalogo API completo

Esempio di richiesta

Inizia dall’operazione documentata

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

Usa l’URL base API della documentazione dell’account e sostituisci i segnaposto. Invia la chiave API nell’header Authorization, mai in un URL o file del repository.

Endpoint

Tre operazioni per account e cronologie

Cerca per nome utente GET /v1/twitter/users?username=<USERNAME>

Leggi il data.id restituito come stringa per le richieste successive.

Cerca per ID utente GET /v1/twitter/users/<USER_ID>

Recupera un account noto e seleziona facoltativamente i campi del profilo.

Cronologia utente GET /v1/twitter/users/<USER_ID>/tweets

Imposta max_results e passa pagination_token per le pagine successive.

Parametri di query

Seleziona campi e pagina la cronologia

Ricerca account: username è obbligatorio su /v1/twitter/users. Entrambi gli endpoint accettano una lista user.fields separata da virgole, come description,public_metrics.
Dimensione pagina: max_results accetta interi da 1 a 100. È un limite massimo per la pagina, non garantisce quel numero di post.
Campi della cronologia: Usa tweet.fields=created_at,public_metrics per date e metriche. Richiedi expansions=author_id con user.fields per i dettagli disponibili sull’autore. Usa exclude=replies,retweets per escludere questi tipi di post.
Pagina successiva: Passa meta.next_token della risposta come pagination_token nella richiesta successiva. Trattalo come opaco e codificalo per URL. Fermati quando manca il token, raggiungi il budget di pagine o un token si ripete.

Gestione delle risposte

Leggi direttamente i risultati JSON

Le ricerche restituiscono l’account in data. Le cronologie contengono un array data e meta.result_count, con meta.next_token se c’è un altro cursore. I dettagli degli autori possono apparire in includes.users.

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

Esempio di cronologia vuota, non un risultato live. Campi opzionali e cursori possono mancare. Una pagina vuota non prova che l’account non abbia mai pubblicato.

Errori di validazione

Correggi i parametri non validi prima di riprovare

Un username mancante o max_results fuori intervallo restituisce HTTP 400 con success: false, error.code: 10001, error.message e requestId. Leggi il messaggio e correggi la richiesta prima di riprovare.

Tracciamento delle richieste

Conserva un ID richiesta, non una credenziale

Conserva l’header X-Request-Id per assistenza e tracciamento. Controlla lo stato HTTP prima di leggere un risultato positivo ed escludi chiavi API e dati di profilo non necessari dai log.