# Phản hồi bài đăng Felo X

POST /api/v1/data/x/tweet/replies

Chọn thao tác cho dữ liệu bạn cần. Cả năm endpoint đều dùng POST và trả về JSON ở gốc, không có bao bọc `data` chung.

Tất cả ví dụ dùng `FELO_API_KEY` từ [tổng quan](https://openapi.felo.ai/vi/docs/data-api/guides/felo-overview.md). Các cuộc gọi sử dụng **số dư nền tảng**, không phải tín dụng Felo Pro. Các ví dụ phản hồi chỉ mang tính minh họa; nội dung thực tế và các trường tùy chọn sẽ thay đổi.





## 5. Đọc phản hồi

`POST /api/v1/data/x/tweet/replies`

| Trường | Kiểu | Bắt buộc | Ý nghĩa |
|---|---|---|---|
| `tweet_ids` | string or string array | Có | Một ID bài đăng hoặc một lô tối đa 20 ID |
| `cursor` | string | Không | Tối đa 4.000 ký tự; dùng với một ID bài đăng |
| `since_time` | integer | Không | Thời gian bắt đầu theo giây Unix |
| `until_time` | integer | Không | Thời gian kết thúc theo giây Unix |

Thay thế chỗ giữ chỗ bằng một ID bài đăng thực:

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/tweet/replies" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet_ids":["POST_ID"]}'
```

Không giống như dòng thời gian và tìm kiếm bài đăng, các phản hồi được nhóm dưới `results`. Mỗi mục có trạng thái phân trang riêng:

```json
{"results":[{"tweet_id":"POST_ID","replies":[],"total":0,"has_next":false,"next_cursor":null}]}
```

### Giới hạn phản hồi cho mỗi yêu cầu

Mỗi yêu cầu đọc một trang phản hồi upstream cho mỗi `tweet_id` và giữ tối đa 100 phản hồi; nó không tự động lấy mọi trang phản hồi. Trong một lô tối đa 20 ID, giới hạn 100 phản hồi áp dụng riêng cho từng mục `results`. Số lượng thực tế có thể thấp hơn.

`total` của mỗi mục là số phản hồi được trả về trong mục đó, không phải tổng số phản hồi đầy đủ của bài đăng. Để tiếp tục, dùng `next_cursor` của mục đó và chỉ gửi ID bài đăng đơn lẻ của nó trong yêu cầu tiếp theo. Không có tham số `limit` để tăng giới hạn mỗi yêu cầu.



## Phân trang và kiểm soát chi phí

`total` đếm mảng tương ứng trong phản hồi hiện tại: các bài đăng cấp cao nhất cho truy vấn bài đăng, hoặc các phản hồi trong từng mục kết quả cho truy vấn phản hồi. Nó không phải là số lượng khớp toàn cục, không phải tổng số phản hồi đầy đủ của bài đăng, cũng không phải số lượng tính phí cuối cùng.

1. Gửi yêu cầu đầu tiên không có `cursor`.
2. Đọc `has_next` và `next_cursor` từ phản hồi. Với phản hồi, đọc chúng trên từng mục kết quả.
3. Nếu còn trang khác và con trỏ không rỗng, gửi lại nguyên trạng cùng truy vấn đó. Với một lô phản hồi, tiếp tục từng bài đăng riêng biệt.
4. Dừng khi không còn trang tiếp theo, khi con trỏ lặp lại, hoặc khi giới hạn trang hay chi tiêu của bạn đã đạt.

Siêu dữ liệu phân trang phản ánh phản hồi upstream cuối cùng; bộ sưu tập trả về có thể bị cắt ở một giới hạn kết quả. Ngay cả `has_next=false` cũng không đảm bảo rằng toàn bộ lịch sử X hoặc phản hồi đã được lấy. Hiển thị số lượng thực tế trả về thay vì gắn nhãn một tập kết quả có giới hạn là toàn bộ dữ liệu có sẵn.

Mỗi trang thành công có thể phát sinh phí. Năm thao tác này được tính phí theo kết quả trả về, không phải phí cố định theo yêu cầu. Phản hồi lồng nhau và các bản ghi khác được trả về có thể ảnh hưởng đến số lượng bị tính phí; đừng ước tính chi phí chỉ dựa trên độ dài mảng cấp cao nhất. Kiểm tra [giá hiện tại](https://openapi.felo.ai/api/v1/data/prices) và mức sử dụng trong console. Các trường đối tượng đầy đủ có trong [lược đồ OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).