API Hop

Documentazione

Documentazione API Hop

Twitter API

Usa un’API Twitter unificata per interrogare profili e cronologie con strutture di risposta X API v2.

Questo servizio offre un’API REST Twitter unificata. I client ricevono strutture di risposta coerenti nello stile di X API v2.

text
/v1/twitter

Autenticazione

Tutti gli endpoint dell’API Twitter richiedono l’autenticazione con token Bearer.

http
Authorization: Bearer YOUR_API_KEY

Percorso di base

Chiama questi percorsi relativi sotto l’URL di base dell’API.

text
GET https://api.apihop.ai/v1/twitter/users
GET https://api.apihop.ai/v1/twitter/users/{id}
GET https://api.apihop.ai/v1/twitter/users/{id}/tweets

Struttura della risposta

Le risposte Twitter riuscite non sono racchiuse in success/data; restituiscono direttamente i campi normalizzati data, includes e meta.

Funzionalità supportate

Informazioni sull’utenteCerca un utente Twitter tramite username oppure recupera direttamente la risorsa utente tramite id.Cronologia dell’utenteRecupera la cronologia di un utente tramite id, con tweet normalizzati, autori espansi e metadati di paginazione.
  1. Se hai solo un username, recupera prima l’utente per nome utente e leggi data.id.
  2. Usa data.id per recuperare la cronologia dell’utente.
  3. Se ti servono i profili degli autori nelle risposte della cronologia, passa expansions=author_id.

Regole di normalizzazione

  • Gli endpoint utente restituiscono un oggetto utente: { "data": { ... } }
  • Gli endpoint della cronologia restituiscono un array di tweet: { "data": [ ... ], "meta": { ... } }
  • Quando viene richiesto expansions=author_id, le risposte della cronologia includono includes.users
  • user.fields e tweet.fields controllano la selezione dei campi opzionali
  • Gli oggetti utente conservano sempre id, name e username
  • Gli oggetti tweet conservano sempre id e text

Campi opzionali

user.fields

Campi utente normalizzati supportati:

  • created_at
  • description
  • entities
  • location
  • pinned_tweet_id
  • profile_banner_url
  • profile_image_url
  • protected
  • public_metrics
  • url
  • verified
  • verified_type

tweet.fields

Campi tweet normalizzati supportati:

  • attachments
  • author_id
  • conversation_id
  • created_at
  • edit_history_tweet_ids
  • entities
  • in_reply_to_user_id
  • lang
  • possibly_sensitive
  • public_metrics
  • referenced_tweets
  • source

Diagnostica

  • Ogni risposta include X-Request-Id
  • Registralo in caso di chiamate non riuscite, risultati anomali o limiti di frequenza
  • Per domande sulla fatturazione, conserva X-Request-Id e l’ora della richiesta

Endpoint disponibili

Recuperare un utente per nome utenteGET https://api.apihop.ai/v1/twitter/users?username=elonmuskRecuperare un utente per IDGET https://api.apihop.ai/v1/twitter/users/44196397Recuperare la cronologia dell’utenteGET https://api.apihop.ai/v1/twitter/users/44196397/tweets