API Hop

Documentation

Documentation API Hop

API Twitter

Utilisez une API Twitter unifiée pour consulter les profils et fils d’utilisateurs avec des réponses au format X API v2.

Ce service fournit une API REST Twitter unifiée. Les clients reçoivent des structures de réponse cohérentes au format X API v2.

text
/v1/twitter

Authentification

Tous les endpoints de l’API Twitter nécessitent une authentification par jeton Bearer.

http
Authorization: Bearer YOUR_API_KEY

Chemin de base

Appelez ces chemins relatifs sous votre URL de base 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

Structure des réponses

Les réponses réussies de l’API Twitter ne sont pas enveloppées dans success/data ; elles renvoient directement les champs normalisés data, includes et meta.

Capacités prises en charge

Informations utilisateurRecherchez un utilisateur Twitter par username ou consultez directement une ressource utilisateur par id.Fil d’utilisateurConsultez le fil d’un utilisateur par id, avec publications normalisées, auteurs détaillés et métadonnées de pagination.
  1. Si vous disposez uniquement d’un username, appelez d’abord Obtenir un utilisateur par nom, puis lisez data.id.
  2. Utilisez data.id pour appeler Obtenir le fil d’un utilisateur.
  3. Si vous avez besoin des profils des auteurs dans les réponses de fil, passez expansions=author_id.

Règles de normalisation

  • Les endpoints utilisateur renvoient un objet utilisateur : { "data": { ... } }
  • Les endpoints de fil renvoient un tableau de publications : { "data": [ ... ], "meta": { ... } }
  • Lorsque expansions=author_id est demandé, les réponses de fil incluent includes.users
  • user.fields et tweet.fields contrôlent la sélection des champs optionnels
  • Les objets utilisateur conservent toujours id, name et username
  • Les objets de publication conservent toujours id et text

Champs optionnels

user.fields

Champs utilisateur normalisés pris en charge :

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

tweet.fields

Champs de publication normalisés pris en charge :

  • 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

Diagnostic

  • Chaque réponse inclut X-Request-Id
  • Consignez-le lorsque les appels échouent, que les résultats semblent anormaux ou que le service applique une limite de débit
  • Pour les questions de facturation, conservez X-Request-Id et l’heure de la requête

Points de terminaison

Obtenir un utilisateur par nomGET https://api.apihop.ai/v1/twitter/users?username=elonmuskObtenir un utilisateur par IDGET https://api.apihop.ai/v1/twitter/users/44196397Obtenir le fil d’un utilisateurGET https://api.apihop.ai/v1/twitter/users/44196397/tweets