Các truy vấn của Cửa hàng Nhà sáng tạo

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Bạn có thể tìm kiếm tài sản của Roblox bên ngoài Studio bằng cách truy cập API Cửa hàng Nhà sáng tạo.Sử dụng API Cửa hàng Nhà sáng tạo để truy vấn tài sản Studio, chẳng hạn như lưới, mô hình và âm thanh, và API Thị trường để truy vấn tài sản avatar trên Thị trường.

Mỗi API yêu cầu một URL và các tham số tìm kiếm tùy chỉnh cho danh mục cụ thể đó.Nếu cả URL và tham số đều hợp lệ, API trả về định dạng JSON với kết quả tìm kiếm của bạn.

API Cửa hàng Nhà sáng lập

Đối với thông tin về việc gọi API Cửa hàng Nhà sáng tạo cho tìm kiếm, xem Dịch vụ Hộp công cụ trong Mở tham chiếu đám mây.

API Thị trường

Bạn có thể truy vấn các vật phẩm avatar từ Marketplace bằng URL sau: https://catalog.roblox.com/v1/search/items/details?[params]

Bạn có thể thay thế [params] bằng các tham số truy vấn thích hợp để tùy chỉnh tìm kiếm của bạn.

Tham số truy vấn

Bạn có thể xác định tham số tìm kiếm bằng cách thêm một loạt các tham số và giá trị vào URL, mỗi tham số được tách bởi một &.

Sử dụng các tham số sau để truy vấn Marketplace:

Tham sốLoạiTùy chọn và giá trị
Thể loạiđoạn văn= Nổi bật > = Tất cả = Đồ sưu tầm = Quần áo = Phần thân = Thiết bị = Phụ kiện = Hoạt hình cộng đồng = Sáng tạo cộng đồng = Hình ảnh Avatar = Cộng đồng cộng tác = Công cụ = Tài nguyên = Hướng dẫn = Câu hỏi thường gặp = Tài liệu tham khảo = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tácác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tácác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tácác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng tác viên = Cộng táng tác viên = Cộng tác viên = Cộng táng táng viên = Cộng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng tángáng tángáng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng táng
Loại Tạo Viênđoạn văn1 = Người dùng 2 = Nhóm
Tên Tạo ViênchuỗiTìm kiếm theo tên của người tạo. Nếu Enum.CreatorType không được cung cấp, tìm kiếm chỉ dành cho người dùng.
Người tạo mục tiêuIddàiID người dùng hoặc nhóm tùy thuộc vào CreatorType được cung cấp.
Trình con trỏchuỗiMỗi phản hồi tìm kiếm có chứa một nextPageCursor nếu có trang tiếp theo và previousPageCursor nếu có trang trước.Chuyển bất kỳ giá trị nào trong tham số Cursor của truy vấn tiếp theo để lấy trang tiếp theo hoặc trang trước của kết quả.Con trỏ là hợp lệ nếu các tham số truy vấn khác vẫn giữ nguyên.
Thể loạiđoạn vănXác định thể loại cho tìm kiếm.Cách tiếp cận được đề xuất để lọc theo thể loại là phù hợp với URL của một trang danh mục. = Thị trấn và thành phố = Thời trung cổ > = SciFi = Chiến đấu = Kinh dị = Hải quân = Phiêu lưu = Thể thao = Hài hước = Quân sự = Xây dựng = FPS = RPG
Từ khóachuỗiTìm tìm kiếmtừ khóa tiêu chuẩn.
Giới hạn

int ngôn ngữ english:int

Số kết quả để trả về. Các giá trị hiện được giới hạn ở 10, 28 và 30.
Giá tối đa

int ngôn ngữ english:int

Giá tối đa trong Robux của các mục trong truy vấn.
Giá tối thiểu

int ngôn ngữ english:int

Giá tối thiểu trong Robux của các mặt hàng trong truy vấn.
Sắp xếp Aggregationđoạn văn1 = Ngày trước 3 = Tuần trước 4 = Tháng trước 5 = Tất cả thời gian
Loại sắp xếpđoạn văn= Sự liên quan (Mặc định) > = Ưa thích > = Bán hàng > = Cập nhật > = Giá tăng > = Giá giảm > = Giá tăng > = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá giảm = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng = Giá tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tăng tă
Thể loại conđoạn vănTiếng Việt tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng Tiếng

URL sau đây sẽ tìm kiếm các vật phẩm "Gear" đầu tiên trong "Phụ kiện" được sắp xếp theo thời gian ("SortAggregation") và liên quan ("SortType") tạo bởi Roblox ("CreatorTargetId"):

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

Các trường phản hồi

Các phản hồi API trả về trong định dạng JSON. Phản hồi cung cấp chi tiết tài sản trong chìa khóa data bằng các trường sau:

TrườngMô tả
loại tài sảnMột trong các giá trị loại tài sản sau (chỉ trả về nếu mục là một tài sản). = Áo thun = Mũ = Áo sơ mi = Quần = Áo khoác > = Găng tay > = Mũ bảo hiểm > = Kính râm > = Túi > = Túi đeo chéo > = Ví tiền > = Vòng cổ > = Vòng tay > = Vòng cổ tay > = Đồng hồi > = Áo khoác > = Mũ lưỡ > = Áo thun > = Áo thunis = Áo khoác = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun = Áo thun thun thun thun thun = Áo thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun thun
loại góiID kiểu gói (chỉ trả về nếu mục là một gói). Các giá trị có thể là BodyParts và AvatarAnimations .
tên của người tạoTên của nhà sáng tạotạo.
ID mục tiêu tạo raVôi creatorTargetIdID của người tạo.
loại tạo raTypeLoại nhà sáng đánh máycủa vật phẩm.
miêu tảtảMô tả vật miêu tả.
số yêu thíchSố yêu thích của một vật phẩm.
thể loạiDanh sách các thể loại của vật phẩm.Các giá trị có thể bao gồm All , Tutorial , Scary , TownAndCity , War , Funny , Fantasy , Adventure , SciFi , Pirate , FPS , RPG , Sports , Ninja , và WildWest .
idID của vật phẩm.
hạn chế vật phẩmDanh sách các hạn chế của vật phẩm. Các giá trị có thể bao gồm ThirteenPlus , LimitedUnique , Limited , và Rthro .
trạng thái mụcDanh sách cờ hiệu trạng thái của vật phẩm.Các giá trị có thể bao gồm New , Sale , XboxExclusive , AmazonExclusive , GooglePlayExclusive , IosExclusive , và SaleTimer .
loại vật phẩmLoại vật đánh máy. Các giá trị có thể là Asset hoặc Bundle .
giá thấp nhấtGiá bán lẻ thấp nhất của mặt hàng (chỉ trả lại nếu mặt hàng có thể bán lại).
tênTên của mục.
giáGiá danh sách của mặt hàng (giá hiện tại có thể khác nhau nếu mặt hàng có thể bán lại).
trạng thái giáTình trạng giá của một mặt hàng không đang mua bán. Các giá trị có thể là Free , OffSale , hoặc NoResellers .
số lần muaSố lần mua của một vật phẩm.
các đơn vị có sẵn cho tiêu thụCác đơn vị có sẵn để tiêu thụ một mặt vật phẩmduy nhất giới hạn.

Dưới đây là một ví dụ về sản phẩm trả lại mong đợi cho một vật phẩmduy nhất:

{

	"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

        }

	]

}