API Hop

Twitter API

API Twitter: tra cứu người dùng, dòng thời gian và phân trang

Tích hợp endpoint Twitter / X của API Hop với xác thực Bearer, lựa chọn trường người dùng và tweet, phân trang con trỏ và xử lý lỗi xác thực dữ liệu.

Tra cứu tên người dùng thành ID, lấy dòng thời gian và gửi token tiếp theo được trả về để yêu cầu trang khác. Lệnh gọi thành công trả JSON trực tiếp; các endpoint này không có bước thăm dò Jobs.

Dành cho tác vụ cụ thể

Triển khai ba thao tác GET được hỗ trợ và xử lý kết quả.

01

Tra cứu tài khoản theo tên người dùng và chọn trường hồ sơ trả về.

02

Làm mới tài khoản đã biết theo ID mà không cần tra cứu lại tên người dùng.

03

Lấy trang dòng thời gian với giới hạn kích thước trang và token phân trang.

Đơn vị tính phí

Hiểu cách đo mức sử dụng

USD trên mỗi yêu cầu.

Giới hạn vận hành

  • Trường trả về phụ thuộc vào tham số truy vấn đã có tài liệu và phản hồi thượng nguồn.
  • max_results phải là số nguyên từ 1 đến 100. Một trang có thể chứa ít kết quả hơn.
  • Giữ ID người dùng và tweet dưới dạng chuỗi để tránh mất độ chính xác số.

Hướng dẫn tích hợp

Chọn bước tiếp theo

Phạm vi danh mục hiện tại

API khả dụng và đơn vị tính phí

So sánh ID API, thao tác, nhà cung cấp và giá. Kiểm tra ngày danh mục và đơn vị tính phí của từng thao tác trước khi ước tính chi phí sử dụng.

API dữ liệu

Twitter User Data

twitter-user-data Tài liệu
đang hoạt động

Lấy hồ sơ công khai và dòng thời gian của người dùng Twitter / X.

Nhà cung cấp
Twitter / X Data
Đơn vị tính phí
yêu cầu
Định dạng API và endpoint
Xem các thao tác bên dưới để biết endpoint yêu cầu.
Khả năng đã công bố
Tra cứu người dùng, Dòng thời gian người dùng
Thao tác đã công bố
  • GET /v1/twitter/users Lấy người dùng theo tên đăng nhập
  • GET /v1/twitter/users/{id} Lấy người dùng theo ID
  • GET /v1/twitter/users/{id}/tweets Lấy bài đăng của người dùng

Giá API Hop

Yêu cầu
$0.0020 /yêu cầu

Lấy người dùng theo tên đăng nhập

GET /v1/twitter/users

Giá API Hop

Yêu cầu
$0.0020 /yêu cầu

Lấy người dùng theo ID

GET /v1/twitter/users/{id}

Giá API Hop

Yêu cầu
$0.0020 /yêu cầu

Lấy bài đăng của người dùng

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

Giá API Hop

Yêu cầu
$0.0020 /yêu cầu

Ví dụ yêu cầu

Bắt đầu từ thao tác được mô tả trong tài liệu

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

Dùng URL cơ sở API trong tài liệu tài khoản và thay các chỗ giữ chỗ của ví dụ. Gửi khóa API trong header Authorization; tuyệt đối không đưa vào URL hoặc tệp đã commit.

Endpoint

Ba thao tác cho tài khoản và dòng thời gian

Tìm theo tên người dùng GET /v1/twitter/users?username=<USERNAME>

Đọc data.id trả về dưới dạng chuỗi cho yêu cầu tiếp theo.

Tìm theo ID người dùng GET /v1/twitter/users/<USER_ID>

Lấy tài khoản đã biết và tùy chọn trường hồ sơ.

Dòng thời gian người dùng GET /v1/twitter/users/<USER_ID>/tweets

Đặt max_results và truyền pagination_token cho các trang tiếp theo.

Tham số truy vấn

Chọn trường và phân trang dòng thời gian

Tra cứu tài khoản
username là bắt buộc trên /v1/twitter/users. Cả hai endpoint tra cứu chấp nhận danh sách user.fields ngăn bằng dấu phẩy, như description,public_metrics.
Kích thước trang
max_results chấp nhận số nguyên từ 1 đến 100. Đây là giới hạn trên của kích thước trang, không đảm bảo có đủ số bài đăng đó.
Trường dòng thời gian
Dùng tweet.fields=created_at,public_metrics cho thời điểm và chỉ số. Yêu cầu expansions=author_id cùng user.fields khi cần thông tin tác giả khả dụng. Dùng exclude=replies,retweets để loại các loại bài đăng đó.
Trang tiếp
Truyền meta.next_token từ phản hồi dưới dạng pagination_token trong yêu cầu tiếp theo. Coi token là giá trị không diễn giải và mã hóa URL. Dừng khi không có token tiếp theo, đã đạt ngân sách trang hoặc token lặp lại.

Xử lý phản hồi

Đọc trực tiếp kết quả JSON

Tra cứu người dùng trả tài khoản trong data. Phản hồi dòng thời gian chứa mảng data và meta.result_count, cùng meta.next_token khi còn con trỏ tiếp theo. Thông tin mở rộng tác giả có thể xuất hiện trong includes.users.

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

Phản hồi dòng thời gian rỗng để minh họa, không phải kết quả tài khoản trực tiếp. Trường tùy chọn và con trỏ có thể không có. Trang rỗng không chứng minh tài khoản chưa từng đăng bài.

Lỗi xác thực dữ liệu

Sửa tham số không hợp lệ trước khi thử lại

Thiếu username hoặc max_results ngoài khoảng trả HTTP 400 với success: false, error.code: 10001, error.message và requestId. Kiểm tra thông báo và sửa yêu cầu thay vì thử lại mà không thay đổi.

Truy vết yêu cầu

Giữ ID yêu cầu, không giữ thông tin xác thực

Giữ header phản hồi X-Request-Id để hỗ trợ và truy vết yêu cầu. Kiểm tra trạng thái HTTP trước khi đọc dữ liệu thành công và không đưa khóa API hay dữ liệu hồ sơ không cần thiết vào nhật ký ứng dụng.