Cross-platform · Cari postingan

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
`query`	string	Ya	`"人工智能"`	Search terms; separate terms with spaces to require all of them. Put excluded words in exclude_words.
`platforms`	array	Tidak	`["weibo","douyin","toutiao","xiaohongshu","short_video","wechat","news","forum","long_video","app"]`	Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forum Pass a JSON array in this query parameter.
`since`	string	Tidak	`—`	First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until
`until`	string	Tidak	`—`	Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days
`types`	array	Tidak	`["original","repost","comment"]`	Content types, all by default: original, repost, comment Pass a JSON array in this query parameter.
`sentiment`	array	Tidak	`["negative","neutral","positive"]`	Sentiment, all by default: negative, neutral, positive Pass a JSON array in this query parameter.
`match`	array	Tidak	`["title","content","author"]`	Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio Pass a JSON array in this query parameter.
`exclude_words`	string	Tidak	`—`	Filter words; results that contain them are left out
`author`	string	Tidak	`—`	Only content published by this author (account name)
`page`	integer	Tidak	`1`	Page number, from 1, at most 50
`limit`	integer	Tidak	`20`	Results per page: 10 or 20

Contoh permintaan

curl --get "https://api.chinaapi.ai/v1/social/cross-platform/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'query=人工智能'

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

Paginasi

Parameter paginasi: page. Setiap halaman adalah panggilan yang ditagih terpisah; ambil nilai kursor dari respons sebelumnya persis seperti yang diterima.

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.

Manfaat kecepatan API data

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

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].