創作者商店查詢

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

您可以通過存取創作者商店 API 來搜尋 Studio 之外的 Roblox 資產。使用 創作者商店 API 來查詢 Studio 資產，例如網格、模型和音訊，以及 市場 API 來查詢市場上的虛擬人偶資產。

每個 API 需要一個 URL 和自訂搜尋參數來配置特定目錄。如果 URL 和參數都有效，API 將返回 JSON 格式，包含搜尋結果。

創作者商店 API

有關搜搜尋的創作者商店 API 呼叫資訊，請參閱 開啟雲端參考 中的工具箱服務。

市場 API

您可以使用以下 URL 從市場查詢虛擬人偶物品：https://catalog.roblox.com/v1/search/items/details?[params]

您可以將 [params] 替換為適當的 查詢參數 來自訂您的搜尋。

查詢參數

您可以通過添加一系列參數和值到 URL 來指定搜索參數，每個都用 & 分開。

使用以下參數查詢市場：

參數類型選項和值
類別字元0 = 精選 1 = 所有 2 = 收藏品 3 = 服裝 4 = 身體部位 5 = 裝備 11 = 配件 12 = 人物動畫 13 = 社群創作
創作者類型字元1 = 使用者 2 = 群組
創作者名稱字串按創作者名稱搜尋。如果 Enum.CreatorType 未提供，搜尋只適用於使用者。
創作者目標ID長使用者或群組ID取決於提供的創作者類型。
鼠標字串每個搜尋回應包含 nextPageCursor 如果有下一頁，和 previousPageCursor 如果有前一頁。將這些值之一傳送到下一個查詢的曲標參數中，以獲得下一頁或上一頁的結果。其他查詢參數保持相同時，鼠標是有效的。
類別字元指定搜尋的類別。建議對類別進行過濾的方法是匹配目錄頁面的 URL。1 = 城市和城鎮 2 = 中世紀 3 = SciFi 4 = 戰鬥 5 = 恐怖 6 = 海戰 7 = 冒險 8 = 運動 9 = 喜劇 10 = 西部 11 = 戰爭 13 = 建築 14 = FPS 15 = RP角色扮演
關鍵字字串標準關鍵字搜搜尋。
限制int要返傳回的結果數量。目前值限制為 10、28 和 30。
最高價格int查詢中項目的 Robux 最高價格。
最低價格int查詢中項目的 Robux 最低價格。
排序聚合字元1 = 過去一天 3 = 過去一周 4 = 過去一個月 5 = 所有時間
排序類型字元0 = 相關 (預設) 1 = 受青睐 2 = 銷售 3 = 已更新 4 = 價格上升 5 = 價格下降 = 更新
子類別字元

Portuguese Documentation 技術文檔 API 文檔 = 文档 = 文档API 文档 = 文档 = 文档 = 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文档= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔= 文檔=文檔= 文檔= 文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文檔=文

以下URL將搜尋Roblox（「創作者目標ID」）所創建的「配件」中的前10個「裝備」項目，排序為所有時間（「排序聚合」）和相關（「排序類型」），創建於「配件」的：

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

回應欄位

API 回應以 JSON 格式返回。回應提供資產詳情在 data 鍵使用以下欄位：

字段說明
資產類型以下資產類型值之一（僅在物品是素材時返回）。 = 襯衫 = 帽子 = 襯衫 = 褲子 = 頭部 = 面具 = 裝備 = 手臂 = 腿 = 右臂 = 左臂 = 頸部 = 臉部 = 胸部 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰帶 = 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= 腰= = = 腰= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = === = ===========================================================================================================================================================================================================================================================================================================================================================================================================
包裝類型包裝類型ID（僅在物品是組合時返回）。可能值為 BodyParts 和 AvatarAnimations 。
創作者名稱創作者的名稱。
創作者目標ID創作者的ID。
創作者類型項道具的創作者類輸入。
說明項目說明。
最愛數量項道具的最愛數量。
類型項道具類別的列表。可能的值包括 All , Tutorial , Scary , TownAndCity , War , Funny , Fantasy , Adventure , SciFi , Pirate , FPS , RPG , Sports , Ninja , 和 WildWest 。
id項道具的ID。
項目限制列出道具目的限制。可能的值包括 ThirteenPlus、LimitedUnique、Limited 和 Rthro 。
項目狀態項道具狀態旗的列表。可能的值包括 New , Sale , XboxExclusive , AmazonExclusive , GooglePlayExclusive , IosExclusive , 和 SaleTimer 。
項目類型項目類輸入。可能值為 Asset 或 Bundle 。
最低價格物品的最低零售價格（僅於物品可販售時返回）。
名稱項目名稱。
價格項目的列價（如果項目可以轉賣，現有價格可能會有所不同）。
價格狀態一件未發買賣的物品的價格狀態。可能的值是 Free , OffSale 或 NoResellers 。
购买数量一件物道具的購買數量。
可供消費的單位可供限時獨特道具品消費的單位。

以下是單一道具目的預期返回輸出示例：

{

	"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

        }

	]

}