Twitter API

API Twitter: pencarian pengguna, linimasa, dan paginasi

Integrasikan endpoint Twitter / X API Hop dengan autentikasi Bearer, pemilihan bidang pengguna dan tweet, paginasi kursor, serta penanganan kesalahan validasi.

Cari ID pengguna dari nama pengguna, ambil linimasa pengguna tersebut, dan kirim token berikutnya yang dikembalikan untuk meminta halaman lain. Panggilan yang berhasil langsung mengembalikan JSON; tidak ada tahap polling Jobs untuk endpoint ini.

Dapatkan kunci API Jelajahi Katalog API

Dirancang untuk tugas tertentu

Implementasikan tiga operasi GET yang didukung dan tangani hasilnya.

Cari akun berdasarkan nama pengguna dan pilih bidang profil yang akan dikembalikan.

Segarkan akun yang diketahui berdasarkan ID pengguna tanpa pencarian nama pengguna lagi.

Ambil halaman linimasa dengan batas ukuran halaman dan token paginasi.

Satuan penagihan

Pahami cara penggunaan diukur

USD per permintaan.

Batas operasional

Bidang yang dikembalikan bergantung pada parameter kueri yang didokumentasikan dan respons hulu.
max_results harus berupa bilangan bulat dari 1 hingga 100. Sebuah halaman dapat berisi lebih sedikit hasil.
Simpan ID pengguna dan ID tweet sebagai string agar tidak kehilangan presisi numerik.

Panduan integrasi

Pilih langkah berikutnya

Rencanakan penyegaran dan penyimpanan Batasi jumlah permintaan, hilangkan duplikat kiriman, dan catat waktu pengambilan dalam aplikasi Anda. Katalog API data Tinjau produk data, operasi, dan harga berbasis permintaan saat ini.

Cakupan katalog saat ini

API yang tersedia dan satuan penagihan

Bandingkan ID API, operasi, penyedia, dan harga. Periksa tanggal katalog serta satuan penagihan setiap operasi sebelum memperkirakan biaya penggunaan.

API data

Twitter User Data

twitter-user-data Dokumentasi

tersedia

Ambil profil pengguna dan linimasa pengguna Twitter / X yang bersifat publik.

Penyedia: Twitter / X Data
Satuan penagihan: permintaan
Format dan endpoint API: Lihat operasi di bawah untuk endpoint permintaan.
Kemampuan yang dipublikasikan: Pencarian pengguna, Linimasa pengguna

Operasi yang dipublikasikan

GET /v1/twitter/users Ambil pengguna berdasarkan nama pengguna
GET /v1/twitter/users/{id} Ambil pengguna berdasarkan ID pengguna
GET /v1/twitter/users/{id}/tweets Ambil postingan pengguna

Harga API Hop

Permintaan: $0.0020 /permintaan

Ambil pengguna berdasarkan nama pengguna

GET /v1/twitter/users

Harga API Hop

Permintaan: $0.0020 /permintaan

Ambil pengguna berdasarkan ID pengguna

GET /v1/twitter/users/{id}

Harga API Hop

Permintaan: $0.0020 /permintaan

Ambil postingan pengguna

GET /v1/twitter/users/{id}/tweets

Harga API Hop

Permintaan: $0.0020 /permintaan

Buka Katalog API lengkap

Contoh permintaan

Mulai dari operasi yang didokumentasikan

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

Gunakan URL dasar API dari dokumentasi akun Anda dan ganti penanda pengganti contoh. Kirim kunci API melalui header Authorization; jangan pernah menyertakannya dalam URL atau berkas yang dimasukkan ke repositori.

Endpoint

Tiga operasi untuk akun dan linimasa

Cari berdasarkan nama pengguna GET /v1/twitter/users?username=<USERNAME>

Baca data.id yang dikembalikan sebagai string untuk permintaan berikutnya.

Cari berdasarkan ID pengguna GET /v1/twitter/users/<USER_ID>

Ambil akun yang diketahui dan pilih bidang profilnya jika diperlukan.

Linimasa pengguna GET /v1/twitter/users/<USER_ID>/tweets

Tetapkan max_results dan kirim pagination_token untuk halaman berikutnya.

Parameter kueri

Pilih bidang dan telusuri halaman linimasa

Pencarian akun: username wajib pada /v1/twitter/users. Kedua endpoint pencarian menerima daftar user.fields yang dipisahkan koma, seperti description,public_metrics.
Ukuran halaman: max_results menerima bilangan bulat dari 1 hingga 100. Ini adalah batas atas ukuran halaman, bukan jaminan jumlah kiriman tersebut.
Bidang linimasa: Gunakan tweet.fields=created_at,public_metrics untuk stempel waktu dan metrik. Minta expansions=author_id bersama user.fields ketika Anda membutuhkan detail penulis yang tersedia. Gunakan exclude=replies,retweets untuk mengecualikan jenis kiriman tersebut.
Halaman berikutnya: Kirim meta.next_token dari respons sebagai pagination_token pada permintaan berikutnya. Perlakukan token sebagai nilai buram dan enkode untuk URL. Berhenti ketika tidak ada token berikutnya, anggaran halaman tercapai, atau token berulang.

Penanganan respons

Baca hasil JSON secara langsung

Pencarian pengguna mengembalikan akun dalam data. Respons linimasa berisi array data dan meta.result_count, dengan meta.next_token jika kursor lain tersedia. Perluasan penulis dapat muncul dalam includes.users.

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

Ilustrasi respons linimasa kosong, bukan hasil akun langsung. Bidang opsional dan kursor mungkin tidak tersedia. Halaman kosong bukan bukti bahwa akun belum pernah mengirim kiriman.

Kesalahan validasi

Perbaiki parameter tidak valid sebelum mencoba lagi

username yang tidak ada atau max_results di luar rentang mengembalikan HTTP 400 dengan success: false, error.code: 10001, error.message, dan requestId. Periksa pesan dan perbaiki permintaan alih-alih mengulanginya tanpa perubahan.

Pelacakan permintaan

Simpan ID permintaan, bukan kredensial

Simpan header respons X-Request-Id untuk dukungan dan pelacakan permintaan. Periksa status HTTP sebelum membaca muatan keberhasilan, dan jangan masukkan kunci API serta data profil yang tidak diperlukan ke log aplikasi.