Douyin · Tìm chủ đề

Beta

Dữ liệu công khai từ các nền tảng mạng xã hội, tính phí theo lệnh gọi, dùng chung khóa API và số dư với các lệnh gọi mô hình.

Tài khoản chưa thanh toán: tối đa 50 lượt gọi mỗi ngày. Tài khoản đã thanh toán không bị giới hạn số lượt gọi hằng ngày. Đặt lại lúc 00:00 UTC. · Chỉ tính phí khi lệnh gọi trả về HTTP 200 với data không rỗng; kết quả rỗng, tham số bị từ chối hoặc lỗi từ phía nguồn đều không tính phí.

Tham số yêu cầu

Tham số đặt trong query string theo đúng tên của nền tảng. Ví dụ lấy từ danh mục; hãy thay các định danh bằng nội dung bạn muốn lấy.

Tên	Loại	Bắt buộc	Ví dụ	Mô tả
`keyword`	string	Có	`"美食"`	Topic keyword
`start_date`	string	Có	`"20261026"`	Start date YYYYMMDD
`end_date`	string	Có	`"20261101"`	End date YYYYMMDD

Ví dụ yêu cầu

curl --get "https://api.chinaapi.ai/v1/social/douyin/topic-search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=美食' \
  --data-urlencode 'start_date=20261026' \
  --data-urlencode 'end_date=20261101'

Cấu trúc phản hồi

Phản hồi thành công bọc dữ liệu của nền tảng trong một lớp vỏ nhỏ. Mọi thứ bên trong data — tên trường, con trỏ phân trang, ID — đều là của nền tảng; hãy gửi lại con trỏ đúng như khi nhận được.

{
  "object": "social.result",
  "platform": "douyin",
  "capability": "topic-search",
  "data": { … }
}

Phân trang

Endpoint này không có tham số phân trang.

Lỗi và các trường hợp không tính phí

Mã trạng thái	Mã lỗi	Ý nghĩa
400	—	Một tham số không xác định, bị lặp, quá dài, sai kiểu hoặc bị thiếu, kể cả khi không có thành viên nào của nhóm "ít nhất một trong" được cung cấp. Trường `code` của lỗi cho biết là trường hợp nào, ví dụ `unknown_parameter` hoặc `missing_parameter`.
403	—	Khóa API không có quyền thực hiện yêu cầu này.
404	`social_data_no_result`	Cặp nền tảng và chức năng không tồn tại, hoặc nền tảng không tìm thấy gì với các tham số này (`social_data_no_result`).
429	`data_api_daily_limit_exceededsocial_data_capacity_reached`	Dung lượng trong ngày của bản beta đã hết và sẽ đặt lại lúc 00:00 UTC, hoặc nền tảng đang bận và thử lại sau vài giây là được. Đừng thử lại liên tục trong một vòng lặp sát nhau. Tài khoản chưa thanh toán: tối đa 50 lượt gọi mỗi ngày. Tài khoản đã thanh toán không bị giới hạn số lượt gọi hằng ngày. Đặt lại lúc 00:00 UTC.
502	`social_data_no_result`	Nguồn dữ liệu không phản hồi, hoặc phản hồi mà không có dữ liệu.
503	`social_data_unavailable`	Endpoint này hiện đang tạm dừng; danh mục trực tiếp ghi nó là `paused`.

Không phản hồi nào trong số này bị tính phí.

Mỗi phản hồi đều có header X-Oneapi-Request-Id; hãy gửi kèm khi liên hệ hỗ trợ để chúng tôi tìm đúng lệnh gọi đó.

Điều khoản bản beta

Tài khoản chưa thanh toán: tối đa 50 lượt gọi mỗi ngày. Tài khoản đã thanh toán không bị giới hạn số lượt gọi hằng ngày. Đặt lại lúc 00:00 UTC. Bản beta không có SLA, và các nền tảng, endpoint cũng như giá có thể thay đổi.

Tuân thủ điều khoản của từng nền tảng và các quy định bảo vệ dữ liệu áp dụng cho bạn. Không dùng API này để lập hồ sơ cá nhân. Đăng nhập, trích xuất thông tin liên hệ, thao túng lượt tương tác và truy cập nội dung riêng tư hoặc trả phí nằm ngoài phạm vi bản beta này.

Quyền lợi tốc độ API dữ liệu

Tài khoản trả phí bắt đầu từ 10 yêu cầu/giây và tự động tăng theo chi tiêu ròng tích lũy, tối đa 100 yêu cầu/giây.

Tài khoản chưa thanh toán: tối đa 50 lượt gọi mỗi ngày. Tài khoản đã thanh toán không bị giới hạn số lượt gọi hằng ngày. Đặt lại lúc 00:00 UTC.

Chi tiêu ròng tích lũy	Yêu cầu mỗi giây
Mặc định cho tài khoản trả phí	10/s
Trên 50 USD	20/s
Trên 500 USD	50/s
Trên 1500 USD	100/s

Cơ sở tính: phí API dữ liệu đã quyết toán trừ tiền hoàn cho lệnh gọi. Không tính tiền nạp và chi tiêu API mô hình.

Mọi khóa API trong cùng tài khoản dùng chung tốc độ này. Đây là số yêu cầu mỗi giây, không phải số yêu cầu đồng thời.

Các endpoint của nhà cung cấp có giới hạn năng lực riêng, cũng ảnh hưởng đến thông lượng thực tế.

Cần tốc độ cao hơn? Hãy gửi email cho chúng tôi qua [email protected].