API Hop

Documentação

Documentação do API Hop

Twitter API

Use uma API unificada do Twitter para consultar perfis e linhas do tempo com estruturas de resposta da X API v2.

Este serviço oferece uma API REST unificada do Twitter. Os clientes recebem estruturas de resposta consistentes no estilo da X API v2.

text
/v1/twitter

Autenticação

Todos os endpoints da API do Twitter exigem autenticação com token Bearer.

http
Authorization: Bearer YOUR_API_KEY

Caminho base

Chame estes caminhos relativos sob a URL base da 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

Estrutura da resposta

As respostas bem-sucedidas do Twitter não são envolvidas em success/data; retornam diretamente os campos normalizados data, includes e meta.

Recursos compatíveis

Informações do usuárioConsulte um usuário do Twitter por username ou recupere diretamente um recurso de usuário por id.Linha do tempo do usuárioConsulte a linha do tempo de um usuário por id, com tweets normalizados, autores expandidos e metadados de paginação.
  1. Se você tiver apenas um username, consulte primeiro o usuário pelo nome de usuário e leia data.id.
  2. Use data.id para consultar a linha do tempo do usuário.
  3. Se precisar dos perfis dos autores nas respostas da linha do tempo, envie expansions=author_id.

Regras de normalização

  • Endpoints de usuário retornam um objeto de usuário: { "data": { ... } }
  • Endpoints de linha do tempo retornam um array de tweets: { "data": [ ... ], "meta": { ... } }
  • Quando expansions=author_id é solicitado, as respostas da linha do tempo incluem includes.users
  • user.fields e tweet.fields controlam a seleção de campos opcionais
  • Objetos de usuário sempre mantêm id, name e username
  • Objetos de tweet sempre mantêm id e text

Campos opcionais

user.fields

Campos normalizados de usuário compatíveis:

  • 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 tweet compatíveis:

  • 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

  • Toda resposta inclui X-Request-Id
  • Registre-o em caso de falhas nas chamadas, resultados anormais ou limites de taxa
  • Para dúvidas sobre cobrança, guarde X-Request-Id e o horário da requisição

Endpoints disponíveis

Consultar usuário pelo nome de usuárioGET https://api.apihop.ai/v1/twitter/users?username=elonmuskConsultar usuário por IDGET https://api.apihop.ai/v1/twitter/users/44196397Consultar linha do tempo do usuárioGET https://api.apihop.ai/v1/twitter/users/44196397/tweets