API Hop

Dokumentacja

Dokumentacja API Hop

API Twitter

Używaj ujednoliconego API Twitter do odpytywania profili i osi czasu użytkowników z odpowiedziami w stylu X API v2.

Ta usługa zapewnia ujednolicone REST API Twitter. Wywołujący otrzymują spójne struktury odpowiedzi w stylu X API v2.

text
/v1/twitter

Uwierzytelnianie

Wszystkie punkty końcowe API Twitter wymagają uwierzytelnienia tokenem Bearer.

http
Authorization: Bearer YOUR_API_KEY

Ścieżka bazowa

Wywołuj te ścieżki względne pod bazowym adresem URL swojego 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

Struktura odpowiedzi

Udane odpowiedzi API Twitter nie są opakowane w success/data; bezpośrednio zwracają ujednolicone pola data, includes i meta.

Obsługiwane możliwości

Informacje o użytkownikuWyszukaj użytkownika Twitter według username lub odpytaj zasób użytkownika bezpośrednio według id.Oś czasu użytkownikaPobierz oś czasu użytkownika według id, wraz z ujednoliconymi tweetami, rozwiniętymi autorami i metadanymi stronicowania.
  1. Jeśli masz tylko username, najpierw pobierz użytkownika według nazwy i odczytaj data.id.
  2. Użyj data.id do pobrania osi czasu użytkownika.
  3. Jeśli potrzebujesz danych profilu autora w odpowiedziach osi czasu, przekaż expansions=author_id.

Reguły ujednolicania

  • Punkty końcowe użytkownika zwracają jeden obiekt użytkownika: { "data": { ... } }
  • Punkty końcowe osi czasu zwracają tablicę tweetów: { "data": [ ... ], "meta": { ... } }
  • Przy żądaniu expansions=author_id odpowiedzi osi czasu zawierają includes.users
  • user.fields i tweet.fields kontrolują wybór opcjonalnych pól
  • Obiekty użytkowników zawsze zachowują id, name i username
  • Obiekty tweetów zawsze zachowują id i text

Pola opcjonalne

user.fields

Obsługiwane ujednolicone pola użytkownika:

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

tweet.fields

Obsługiwane ujednolicone pola tweeta:

  • 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

Diagnozowanie

  • Każda odpowiedź zawiera X-Request-Id
  • Zapisz go, gdy wywołania zawodzą, wyniki wyglądają nietypowo lub usługa zwraca ograniczenie częstotliwości
  • W sprawach rozliczeń zachowaj X-Request-Id i czas żądania

Punkty końcowe

Pobierz użytkownika według nazwyGET https://api.apihop.ai/v1/twitter/users?username=elonmuskPobierz użytkownika według IDGET https://api.apihop.ai/v1/twitter/users/44196397Pobierz oś czasu użytkownikaGET https://api.apihop.ai/v1/twitter/users/44196397/tweets