Tra cứu tài khoản theo tên người dùng và chọn trường hồ sơ trả về.
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ả.
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.
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.
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
-
GET /v1/twitter/usersLấ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}/tweetsLấ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
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()) 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
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.
GET /v1/twitter/users/<USER_ID> Lấy tài khoản đã biết và tùy chọn trường hồ sơ.
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
usernamelà bắt buộc trên/v1/twitter/users. Cả hai endpoint tra cứu chấp nhận danh sáchuser.fieldsngăn bằng dấu phẩy, nhưdescription,public_metrics.- Kích thước trang
max_resultschấ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_metricscho thời điểm và chỉ số. Yêu cầuexpansions=author_idcùnguser.fieldskhi cần thông tin tác giả khả dụng. Dùngexclude=replies,retweetsđể loại các loại bài đăng đó. - Trang tiếp
- Truyền
meta.next_tokentừ phản hồi dưới dạngpagination_tokentrong 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.