Data sosial (beta)

GET /v1/social/{platform}/{capability} mengembalikan data publik dari Douyin, Xiaohongshu, TikTok, YouTube, dan platform sosial lainnya, dengan kunci API dan saldo yang sama seperti panggilan model Anda. Setiap platform dan kapabilitas diberi harga per panggilan yang berhasil, dan data adalah respons asli platform — field tidak diseragamkan antarplatform.

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: hanya akun berbayar Selesaikan isi ulang pertama Anda sebelum memanggil. Kredit uji coba tidak dapat dipakai untuk endpoint ini; akun yang belum pernah isi ulang akan menerima HTTP 403 model_requires_topup. Beta ini tidak memiliki SLA, dan platform, endpoint, serta harganya dapat berubah.

Autentikasi dan penagihan

Kirim kunci ChinaAPI Anda sebagai bearer token ke https://api.chinaapi.ai, sama seperti panggilan model mana pun. Satu panggilan ditagih sekali, sesuai harga yang tercantum untuk endpoint-nya, hanya jika mengembalikan HTTP 200 dengan data; hasil kosong, parameter yang ditolak, atau kegagalan upstream tidak dikenai biaya. Setiap halaman yang Anda ambil adalah panggilan terpisah. Log penggunaan Anda mencantumkan setiap panggilan dengan nama yang ditampilkan bersama endpoint-nya, misalnya social-douyin-search.

Respons dan error

Respons yang berhasil membungkus data platform dalam amplop kecil. Semua yang ada di dalam data — nama field, kursor paginasi, ID — milik platform itu sendiri; kirim kembali kursor persis seperti yang Anda terima.

{
  "object": "social.result",
  "platform": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 400 — parameter tidak dikenal, berulang, terlalu panjang, bertipe salah, atau tidak ada, termasuk ketika tidak ada anggota grup "setidaknya salah satu dari" yang diberikan. code pada error menunjukkan yang mana, misalnya unknown_parameter atau missing_parameter.
  • 403 model_requires_topup — akun belum menyelesaikan isi ulang pertamanya.
  • 404 — pasangan platform dan kapabilitas tersebut tidak ada, atau platform tidak menemukan apa pun untuk parameter ini (social_data_no_result).
  • 429 social_data_capacity_reached — kapasitas harian beta sudah habis dan direset pada 00:00 UTC, atau platform sedang sibuk dan mencoba lagi beberapa detik kemudian sudah cukup. Jangan mencoba ulang dalam loop yang rapat.
  • 502 — sumber data tidak menjawab, atau menjawab tanpa data.
  • 503 social_data_unavailable — endpoint ini sedang dijeda; katalog langsung mencantumkannya sebagai paused.

Tidak ada satu pun respons ini yang ditagih.

Penggunaan yang diizinkan

Patuhi ketentuan setiap platform dan aturan perlindungan data yang berlaku bagi Anda. Jangan gunakan API ini untuk membangun profil individu. Login, mengekstrak detail kontak, memanipulasi engagement, dan mengakses konten privat atau berbayar berada di luar cakupan beta ini.

Platform dan harga

USD per panggilan yang berhasil. Setiap harga tertaut ke endpoint-nya di bawah, dan tanda pisah berarti platform tidak menawarkan kapabilitas tersebut. Katalog langsung — GET https://dash.chinaapi.ai/api/social/catalog, tanpa kunci — menjadi acuan untuk apa yang dijual saat ini, termasuk endpoint yang sedang dijeda.

Endpoint

Parameter diletakkan di query string dengan nama milik platform. Contoh diambil dari katalog; ganti pengenal dengan konten yang ingin Anda ambil.