TikTok · Tìm bài đăng

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.

Chỉ dành cho tài khoản đã nạp tiền lần đầu, không có dùng thử miễn phí · 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ó	`"TikTok"`	Search keyword
`offset`	integer	Không	`0`	Page cursor
`search_id`	string	Không	`""`	Search id, need to provide when paging

Ví dụ yêu cầu

curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

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": "tiktok",
  "capability": "search",
  "data": { … }
}

Phân trang

Tham số phân trang: offset, search_id. Mỗi trang là một lệnh gọi tính phí riêng; hãy lấy giá trị con trỏ nguyên văn từ phản hồi trước.

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	`model_requires_topup`	Tài khoản chưa hoàn tất lần nạp tiền đầu tiên.
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	`social_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.
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

Hãy hoàn tất lần nạp tiền đầu tiên trước khi gọi. Tín dụng dùng thử không dùng được cho các endpoint này; tài khoản chưa từng nạp tiền sẽ nhận HTTP 403 model_requires_topup. 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.