Anda dapat mencari aset Roblox di luar Studio dengan mengakses API Toko Creator. Gunakan API Toko Creator untuk melakukan kueri aset Studio, seperti mesh, model, dan audio, dan API Marketplace untuk melakukan kueri aset avatar di Marketplace.
Setiap API memerlukan URL dan parameter pencarian khusus untuk katalog tersebut. Jika baik URL maupun parameter valid, API akan mengembalikan format JSON dengan hasil pencarian Anda.
API Toko Creator
Untuk informasi tentang cara melakukan panggilan ke API Toko Creator untuk pencarian, lihat Layanan Toolbox di referensi Open Cloud.
API Marketplace
Anda dapat melakukan kueri item avatar dari Marketplace menggunakan URL berikut: `https://catalog.roblox.com/v1/search/items/details?[params]``
Anda dapat mengganti [params] dengan parameter kueri yang sesuai untuk menyesuaikan pencarian Anda.
Parameter kueri
Anda dapat menentukan parameter pencarian dengan menambahkan serangkaian parameter dan nilai ke URL, masing-masing dipisahkan oleh &.
Gunakan parameter berikut untuk melakukan kueri ke Marketplace:
| Parameter | Tipe | Opsi dan Nilai |
|---|---|---|
| Kategori | byte | 0 = Unggulan 1 = Semua 2 = Koleksi 3 = Pakaian 4 = BagianTubuh 5 = Alat 11 = Aksesori 12 = AnimasiAvatar 13 = KreasiKomunitas |
| JenisPembuat | byte | 1 = Pengguna 2 = Grup Kueri yang menggunakan JenisPembuat juga memerlukan parameter IDTargetPembuat. |
| IDTargetPembuat | long | ID pengguna atau grup tergantung pada JenisPembuat yang diberikan. Kueri yang menggunakan IDTargetPembuat juga memerlukan parameter JenisPembuat. |
| NamaPembuat | string | Cari berdasarkan nama pembuat. Jika Enum.JenisPembuat tidak diberikan, pencarian hanya untuk pengguna. |
| Kursor | string | Setiap respons pencarian mengandung nextPageCursor jika ada halaman berikutnya dan previousPageCursor jika ada halaman sebelumnya. Lewati salah satu dari nilai ini di parameter Kursor kueri selanjutnya untuk mendapatkan halaman hasil berikutnya atau sebelumnya. Kursor valid jika parameter kueri lainnya tetap sama. |
| Genre | byte | Menentukan genre untuk pencarian. Pendekatan yang direkomendasikan untuk menyaring berdasarkan genre adalah mencocokkan URL halaman katalog. 1 = Kota 2 = AbadPertengahan 3 = SciFi 4 = Pertarungan 5 = Horor 6 = AngkatanLaut 7 = Petualangan 8 = Olahraga 9 = Komedi 10 = Barat 11 = Militer 13 = Bangunan 14 = FPS 15 = RPG |
| KataKunci | string | Pencarian kata kunci standar. |
| Batas | int | Jumlah hasil yang akan dikembalikan. Nilai saat ini dibatasi pada 10, 28, dan 30. |
| HargaMaks | int | Harga maksimum dalam Robux dari item dalam kueri. |
| HargaMin | int | Harga minimum dalam Robux dari item dalam kueri. |
| AgregasiUrutan | byte | 1 = HariLalu 3 = MingguLalu 4 = BulanLalu 5 = SeluruhWaktu |
| JenisUrutan | byte | 0 = Relevansi (Default) 1 = Ditandai 2 = Penjualan 3 = Diperbarui 4 = HargaNaik 5 = HargaTurun |
| Subkategori | byte | 0 = Unggulan 1 = Semua 2 = Koleksi 3 = Pakaian 4 = BagianTubuh 5 = Alat 9 = Topi 10 = Wajah 12 = Kemeja 13 = Kaos 14 = Celana 15 = Kepala 19 = Aksesori 20 = AksesoriRambut 21 = AksesoriWajah 22 = AksesoriLeher 23 = AksesoriBahu 24 = AksesoriDepan 25 = AksesoriBelakang 26 = AksesoriPinggang 27 = AnimasiAvatar 37 = Bundle 38 = BundleAnimasi 39 = AnimasiEmote 40 = KreasiKomunitas 41 = Melee 42 = Jarak 43 = Peledak 44 = Peningkatan 45 = Navigasi 46 = Musik 47 = Sosial 48 = Bangunan 49 = Transportasi 54 = AksesoriKepala 55 = KaosKlasik 56 = KemejaKlasik 57 = CelanaKlasik 58 = AksesoriKaos 59 = AksesoriKemeja 60 = AksesoriCelana 61 = AksesoriJaket 62 = AksesoriSweter 63 = AksesoriPendek 64 = BundleSepatu 65 = AksesoriGaunRok 66 = KepalaDinamis |
URL berikut akan mencari 10 item "Alat" pertama dalam "Aksesori" yang disortir berdasarkan seluruh waktu ("AgregasiUrutan") dan relevansi ("JenisUrutan") yang dibuat oleh Roblox ("IDTargetPembuat" dan "JenisPembuat"):
Bidang respons
Respons API mengembalikan dalam format JSON. Respons tersebut menyediakan detail aset dalam kunci data menggunakan bidang berikut:
| Bidang | Deskripsi |
|---|---|
| tipeAset | Salah satu nilai jenis aset berikut (hanya dikembalikan jika item adalah aset). 2 = Kaos 8 = Topi 11 = Kemeja 12 = Celana 17 = Kepala 18 = Wajah 19 = Alat 25 = Lengan 26 = Kaki 27 = Torso 28 = LenganKanan 29 = LenganKiri 30 = KakiKiri 31 = KakiKanan 41 = AksesoriRambut 42 = AksesoriWajah 43 = AksesoriLeher 44 = AksesoriBahudi 45 = AksesoriDepan 46 = AksesoriBelakang 47 = AksesoriPinggang 48 = AnimasiMemanjat 49 = AnimasiKematian 50 = AnimasiJatuh 51 = AnimasiIdle 52 = AnimasiLompat 53 = AnimasiLari 54 = AnimasiBerenang 55 = AnimasiBerjalan 56 = AnimasiPose 61 = AnimasiEmote |
| tipeBundle | ID tipe bundle (hanya dikembalikan jika item adalah bundle). Nilai mungkin adalah BagianTubuh dan AnimasiAvatar. |
| namaPembuat | Nama pembuat. |
| IDTargetPembuat | ID pembuat. |
| JenisPembuat | Jenis pembuat item. |
| deskripsi | Deskripsi item. |
| jumlahFavorit | Jumlah favorit dari item. |
| genre | Daftar genre item. Nilai yang mungkin termasuk Semua, Tutorial, Menakutkan, Kota, Perang, Lucu, Fantasi, Petualangan, SciFi, Pirat, FPS, RPG, Olahraga, Ninja, dan BaratLiar. |
| id | ID item. |
| restriksiItem | Daftar pembatasan item. Nilai yang mungkin termasuk TerlaluDewasa, TerbatasUnik, Terbatas, dan Rthro. |
| statusItem | Daftar bendera status item. Nilai yang mungkin termasuk Baru, Dijual, EksklusifXbox, EksklusifAmazon, EksklusifGooglePlay, EksklusifIos, dan PenghitungPenjualan. |
| tipeItem | Tipe item. Nilai yang mungkin adalah Aset atau Bundle. |
| hargaTerendah | Harga resell terendah untuk item (hanya dikembalikan jika item dapat dijual kembali). |
| nama | Nama item. |
| harga | Harga daftar item (harga saat ini mungkin berbeda jika item dapat dijual kembali). |
| statusHarga | Status harga item yang tidak dijual. Nilai yang mungkin adalah Gratis, OffSale, atau NoResellers. |
| jumlahPembelian | Jumlah pembelian item. |
| unitTersediaUntukKonsumsi | Unit yang tersedia untuk konsumsi dari item terbatas yang unik. |
Berikut adalah contoh output yang diharapkan untuk pengembalian satu item:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Bandana Jiwa Gelisah",
"description":"Bandana ini tidak akan membantu Anda menyatu dengan hantu, tetapi setidaknya Anda akan tampil gaya.",
"productId":41270974,
"genres":[
"Menakutkan",
"Petualangan"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"Pengguna",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}