Dữ liệu mạng xã hội (beta)

GET /v1/social/{platform}/{capability} trả về dữ liệu công khai từ Douyin, Xiaohongshu, TikTok, YouTube và các nền tảng mạng xã hội khác, dùng chung khóa API và số dư với các lệnh gọi mô hình. Mỗi nền tảng và mỗi chức năng được tính giá theo từng lệnh gọi thành công, và data là phản hồi gốc của nền tảng — các trường không được chuẩn hóa giữa các nền tảng.

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

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
Beta: chỉ dành cho tài khoản trả phí 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.

Xác thực và tính phí

Gửi khóa ChinaAPI của bạn dưới dạng bearer token tới https://api.chinaapi.ai, giống như mọi lệnh gọi mô hình. Một lệnh gọi chỉ bị tính phí một lần, theo giá niêm yết của endpoint, và chỉ khi trả về HTTP 200 kèm dữ liệu; kết quả rỗng, tham số bị từ chối hay lỗi phía thượng nguồn đều không mất phí. Mỗi trang bạn lấy là một lệnh gọi riêng. Nhật ký sử dụng ghi mỗi lệnh gọi dưới tên hiển thị cùng endpoint của nó, chẳng hạn social-douyin-search.

Phản hồi và lỗ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": "search",
  "data": { "...": "the platform's own fields" }
}
  • 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 — 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 — 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í.

Sử dụng hợp lệ

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.

Nền tảng và giá

USD cho mỗi lệnh gọi thành công. Mỗi mức giá liên kết tới endpoint của nó bên dưới, và dấu gạch ngang nghĩa là nền tảng không có chức năng đó. Danh mục trực tiếp — GET https://dash.chinaapi.ai/api/social/catalog, không cần khóa — là căn cứ về những gì đang bán lúc này, kể cả endpoint đang tạm dừng.

Endpoint

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.