Pencarian Toko Pembuat

Anda dapat mencari aset Roblox di luar Studio dengan mengakses API Toko Pencipta.Gunakan API Toko Pencipta untuk menanyai aset Studio, seperti mesh, model, dan audio, dan API Pasar untuk menanyai aset avatar di Pasar.

Setiap API memerlukan URL dan parameter pencarian khusus untuk katalog spesifik itu.Jika URL dan parameter berlaku, API akan mengembalikan format JSON dengan hasil pencarian Anda.

API Toko Pencipta

Untuk informasi tentang membuat panggilan ke API Toko Pencari untuk pencarian, lihat Layanan Kotak Alat di Open Cloud referensi.

API Pasar

Anda dapat menanyakan item avatar dari Marketplace menggunakan URL berikut: https://catalog.roblox.com/v1/search/items/details?[params]

Anda dapat mengganti dengan parameter pencarian yang tepat untuk menyesuaikan pencarian Anda.

Parameter pencarian

Anda dapat menentukan parameter pencarian dengan menambahkan serangkaian parameter dan nilai ke URL, masing-masing dipisahkan oleh &.

Gunakan parameter berikut untuk menanyakan Pasar:

Parameter	Jenis	Opsi dan Nilai
Kategorisasi	batu	= Unggulan = Semua = Koleksi > = Pakaian > = Bagian Tubuh > = Peralatan > = Aksesori > = Animasi Avatar > = Kreasi Komunitas > = Komunitas Kreator
Tipe Pencipta	batu	1 = Pengguna 2 = Grup
Nama Pencipta	string	Cari berdasarkan nama pencipta. Jika Enum.CreatorType tidak disediakan, pencarian hanya untuk pengguna.
PenciptaTargetId	panjang	ID pengguna atau kelompok tergantung pada CreatorType yang disediakan.
Kursor	string	Setiap respons pencarian berisi nextPageCursor jika ada halaman berikutnya dan previousPageCursor jika ada halaman sebelumnya.Lewati salah satu nilai ini dalam parameter Cursor dari pencarian berikutnya untuk mendapatkan halaman berikutnya atau sebelumnya hasil.Kursor valid jika parameter query lainnya tetap sama.
Jenis	batu	Mengidentifikasi genre untuk pencarian.Pendekatan yang direkomendasikan untuk penyaringan pada genre adalah untuk mencocokkan URL halaman katalog. = Kota dan Kota = Abad Pertengahan > = SciFi = Pertempuran = Horor = Navigasi = Petualangan = Olahraga = Komedi = Militer = Bangunan = FPS = RPG
Kata Kunci	string	Pencarian kata kunci standard.
Membatasi	int	Jumlah hasil yang akan dikembalikan. Nilai saat ini terbatas pada 10, 28, dan 30.
Harga Maksimum	int	Harga maksimum di Robux dari item dalam pencarian.
Harga Minimum	int	Harga minimum di Robux dari item dalam pencarian.
Urutkan Aggregasi	batu	1 = Hari Terakhir 3 = Minggu Terakhir 4 = Bulan Terakhir 5 = Sepanjang Waktu
Jenis Urutan	batu	0 = Relevansi (Standar) 1 = Favorit 2 = Penjualan 3 = Diperbarui 4 = HargaAsc 5 = HargaDesc
Subkategori	batu	Bahasa Indonesia=bahasa=id> Dokumentasi Jerman= dokumentasi=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api=api

URL berikut akan mencari 10 item "Peralatan" pertama di "Aksesori" yang disortir berdasarkan waktu ("SortAggregation") dan relevansi ("SortType") yang dibuat oleh Roblox ("CreatorTargetId":

https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&SortType=0&SortAggregation=5&Limit=10

Bidang respons

Respons API dikembalikan dalam format JSON. Respon memberikan rincian aset di kunci data menggunakan bidang berikut:

Bidang	Deskripsi
jenis aset	Salah satu nilai jenis aset berikut (hanya dikembalikan jika item adalah aset). = T-Shirt = Topi = Kaus = Celana = Kemeja = Jaket = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda = Sepeda
jenis bundel	ID jenis bundel (hanya dikembalikan jika item adalah bundel). Nilai yang mungkin adalah BodyParts dan AvatarAnimations .
nama pencipta	Nama kreator.
penciptaTargetId	ID pembuat.
jenis pencipta	ketikpencipta item.
deskripsi	Deskripsi deskripsi.
favoritCount	Hitungan favorit dari item.
jenis	Daftar genre item.Nilai yang mungkin termasuk All , Tutorial , Scary , TownAndCity , War , Funny , Fantasy , Adventure , SciFi , Pirate , FPS , RPG , Sports , Ninja , dan WildWest.
id	ID dari item.
batasan item	Daftar batasan item. Nilai yang mungkin termasuk ThirteenPlus , LimitedUnique , Limited , dan Rthro .
itemStatus	Daftar bendera status item.Nilai yang mungkin termasuk New , Sale , XboxExclusive , AmazonExclusive , GooglePlayExclusive , IosExclusive , dan SaleTimer .
jenis item	ketikitem. Nilai yang mungkin adalah Asset atau Bundle .
harga terendah	Harga reseller terendah dari 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).
status harga	Status harga dari item yang tidak penjualan. Nilai yang mungkin adalah Free , OffSale , atau NoResellers .
pembelianCount	Hitungan pembelian item.
unitTersediaUntukProduksi	Unit yang tersedia untuk konsumsi item unik terbatas.

Berikut adalah contoh output pengembalian yang diharapkan untuk satu item:


{
	"keyword": null,
	"previousPageCursor": null,
	"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
	"data": [
    {
        "id":527373900,
        "itemType":
        "Asset",
        "assetType":42,
        "name":"Restless Souls Bandana",
        "description":"This bandana won't help you blend in with ghosts, but at least you'll be stylish.",
        "productId":41270974,
        "genres":[
          "Scary",
          "Adventure"
          ],
        "itemStatus":[],
        "itemRestrictions":[],
        "creatorType":"User",
        "creatorTargetId":1,
        "creatorName":"Roblox",
        "price":300,
        "favoriteCount":15943,
        "offSaleDeadline":null
        }
	]
}

API Toko Pencipta

API Pasar

Parameter pencarian

Bidang respons

Di halaman ini