Xiaohongshu (RED) · Profil

Beta

Data publik dari platform sosial, ditagih per panggilan, dengan kunci API dan saldo yang sama seperti panggilan model Anda.

Hanya untuk akun yang sudah melakukan isi saldo pertama, tanpa uji coba gratis · Panggilan hanya ditagih jika mengembalikan HTTP 200 dengan data yang tidak kosong; hasil kosong, parameter yang ditolak, dan kegagalan upstream tidak ditagih.

Parameter Permintaan

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

Nama	Jenis	Wajib	Contoh	Deskripsi
`user_id`	string	Tidak	`"61b46d790000000010008153"`	User ID
`share_text`	string	Tidak	`"https://xhslink.com/m/3ZSCJZAMz0a"`	xhslink.com/xhslink.cn/Share link, supports xiaohongshu.com, xhslink.com, xhslink.cn

Setidaknya salah satu dari user_id share_text

Contoh permintaan

curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/user" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=61b46d790000000010008153'

Struktur respons

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

Paginasi

Endpoint ini tidak memiliki parameter paginasi.

Error dan yang tidak ditagih

Kode status	Kode error	Arti
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	`social_data_no_result`	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	`social_data_no_result`	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.

Setiap respons membawa header X-Oneapi-Request-Id; sertakan saat menghubungi dukungan agar kami bisa menemukan panggilan tersebut.

Ketentuan beta

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.

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.