API Hop

Dokumentasi

Dokumentasi API Hop

API Twitter

Gunakan API Twitter terpadu untuk mengueri profil dan linimasa pengguna dengan struktur respons bergaya X API v2.

Layanan ini menyediakan REST API Twitter terpadu. Pemanggil menerima struktur respons bergaya X API v2 yang konsisten.

text
/v1/twitter

Autentikasi

Semua endpoint API Twitter memerlukan autentikasi Bearer Token.

http
Authorization: Bearer YOUR_API_KEY

Jalur Dasar

Panggil jalur relatif ini di bawah Base URL API Anda.

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

Struktur Respons

Respons API Twitter yang berhasil tidak dibungkus dalam success/data; respons langsung mengembalikan kolom data, includes, dan meta yang dinormalisasi.

Kemampuan yang Didukung

Informasi PenggunaKueri pengguna Twitter berdasarkan username, atau kueri sumber daya pengguna secara langsung berdasarkan id.Linimasa PenggunaKueri linimasa pengguna berdasarkan id, termasuk postingan yang dinormalisasi, perluasan penulis, dan metadata paginasi.
  1. Jika Anda hanya memiliki username, panggil Ambil Pengguna Berdasarkan Nama Pengguna terlebih dahulu dan baca data.id.
  2. Gunakan data.id untuk memanggil Ambil Linimasa Pengguna.
  3. Jika membutuhkan data profil penulis dalam respons linimasa, kirim expansions=author_id.

Aturan Normalisasi

  • Endpoint pengguna mengembalikan satu objek pengguna: { "data": { ... } }
  • Endpoint linimasa mengembalikan array postingan: { "data": [ ... ], "meta": { ... } }
  • Jika expansions=author_id diminta, respons linimasa menyertakan includes.users
  • user.fields dan tweet.fields mengontrol pemilihan kolom opsional
  • Objek pengguna selalu mempertahankan id, name, dan username
  • Objek postingan selalu mempertahankan id dan text

Kolom Opsional

user.fields

Kolom pengguna ternormalisasi yang didukung:

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

tweet.fields

Kolom postingan ternormalisasi yang didukung:

  • 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

Penelusuran Kesalahan

  • Setiap respons menyertakan X-Request-Id
  • Catat saat panggilan gagal, hasil terlihat tidak wajar, atau layanan mengembalikan batas laju
  • Untuk pertanyaan penagihan, simpan X-Request-Id dan waktu permintaan

Endpoint

Ambil Pengguna Berdasarkan Nama PenggunaGET https://api.apihop.ai/v1/twitter/users?username=elonmuskAmbil Pengguna Berdasarkan IDGET https://api.apihop.ai/v1/twitter/users/44196397Ambil Linimasa PenggunaGET https://api.apihop.ai/v1/twitter/users/44196397/tweets