Xiaohongshu (RED) · Data dasar kreator

Beta

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

Akun yang belum membayar: maksimal 50 panggilan per hari. Akun berbayar: tanpa batas panggilan harian. Direset pukul 00:00 UTC. · 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	Ya	`"5c668b3e0000000012021605"`	Blogger user ID

Contoh permintaan

curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/creator-base" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'user_id=5c668b3e0000000012021605'

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": "creator-base",
  "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	—	Kunci API tidak memiliki izin untuk permintaan ini.
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	`data_api_daily_limit_exceededsocial_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. Akun yang belum membayar: maksimal 50 panggilan per hari. Akun berbayar: tanpa batas panggilan harian. Direset pukul 00:00 UTC.
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

Akun yang belum membayar: maksimal 50 panggilan per hari. Akun berbayar: tanpa batas panggilan harian. Direset pukul 00:00 UTC. 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.

Manfaat kecepatan API data

Akun berbayar mulai dari 10 permintaan/detik dan meningkat otomatis sesuai pengeluaran bersih kumulatif, hingga 100 permintaan/detik.

Akun yang belum membayar: maksimal 50 panggilan per hari. Akun berbayar: tanpa batas panggilan harian. Direset pukul 00:00 UTC.

Pengeluaran bersih kumulatif	Permintaan per detik
Standar akun berbayar	10/s
Di atas USD 50	20/s
Di atas USD 500	50/s
Di atas USD 1500	100/s

Dasar perhitungan: biaya API data yang telah diselesaikan dikurangi pengembalian dana panggilan. Isi saldo dan pengeluaran API model tidak dihitung.

Semua kunci API dalam satu akun berbagi batas ini. Ukurannya adalah permintaan per detik, bukan permintaan bersamaan.

Endpoint pemasok memiliki batas kapasitas tersendiri yang juga memengaruhi laju pemrosesan yang tersedia.

Perlu kecepatan lebih tinggi? Kirim email ke [email protected].