API Hop

Documentación

Documentación de API Hop

API de Twitter

Usa una API unificada de Twitter para consultar perfiles y cronologías con estructuras de respuesta al estilo X API v2.

Este servicio proporciona una API REST unificada de Twitter. Los clientes reciben estructuras de respuesta coherentes al estilo X API v2.

text
/v1/twitter

Autenticación

Todos los endpoints de la API de Twitter requieren autenticación mediante token Bearer.

http
Authorization: Bearer YOUR_API_KEY

Ruta base

Llama a estas rutas relativas bajo la URL base de tu 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

Estructura de respuesta

Las respuestas correctas de la API de Twitter no se encapsulan en success/data; devuelven directamente los campos normalizados data, includes y meta.

Capacidades admitidas

Información de usuarioConsulta un usuario de Twitter por username o un recurso de usuario directamente por id.Cronología de usuarioConsulta la cronología de un usuario por id, con publicaciones normalizadas, autores ampliados y metadatos de paginación.
  1. Si solo tienes un username, llama primero a Obtener usuario por nombre y lee data.id.
  2. Usa data.id para llamar a Obtener cronología de usuario.
  3. Si necesitas datos del perfil del autor en las respuestas de cronología, envía expansions=author_id.

Reglas de normalización

  • Los endpoints de usuario devuelven un objeto de usuario: { "data": { ... } }
  • Los endpoints de cronología devuelven una matriz de publicaciones: { "data": [ ... ], "meta": { ... } }
  • Al solicitar expansions=author_id, las respuestas de cronología incluyen includes.users
  • user.fields y tweet.fields controlan la selección de campos opcionales
  • Los objetos de usuario siempre conservan id, name y username
  • Los objetos de publicación siempre conservan id y text

Campos opcionales

user.fields

Campos normalizados de usuario admitidos:

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

tweet.fields

Campos normalizados de publicaciones admitidos:

  • 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

Diagnóstico

  • Cada respuesta incluye X-Request-Id
  • Regístralo cuando fallen llamadas, los resultados parezcan anómalos o el servicio aplique límites de velocidad
  • Para consultas de facturación, conserva X-Request-Id y la hora de la solicitud

Puntos de acceso

Obtener usuario por nombreGET https://api.apihop.ai/v1/twitter/users?username=elonmuskObtener usuario por IDGET https://api.apihop.ai/v1/twitter/users/44196397Obtener cronología de usuarioGET https://api.apihop.ai/v1/twitter/users/44196397/tweets