您可以通过访问创建者商店 API 在 Studio 之外搜索 Roblox 的资产。使用 创建者商店 API 查询 Studio 资产，如网格、模型和音频，使用 市场 API 查询市场上的角色资产。
每个 API 需要一个 URL 和特定目录的自定义搜索参数。如果 URL 和参数都有效，API 将返回 JSON 格式的搜索结果。
创建者商店 API
有关如何调用创建者商店 API 进行搜索的信息，请参阅 Open Cloud 参考 中的工具箱服务。
市场 API
您可以使用以下 URL 查询市场上的角色物品： `https://catalog.roblox.com/v1/search/items/details?[params]``
您可以用适当的 查询参数 替换 [params] 来自定义您的搜索。
查询参数
您可以通过向 URL 附加一系列参数和值来指定搜索参数，每个参数之间用 & 分隔。
使用以下参数查询市场：
| 参数 | 类型 | 选项和数值 |
|---|---|---|
| 类别 | byte | 0 = 推荐 1 = 所有 2 = 收藏品 3 = 服装 4 = 身体部件 5 = 装备 11 = 配件 12 = 角色动画 13 = 社区创作 |
| 创作者类型 | byte | 1 = 用户 2 = 群组 使用 创作者类型 进行的查询还需要 创作者目标 ID 参数。 |
| 创作者目标 ID | long | 根据提供的创作者类型的用户或群组 ID。 使用 创作者目标 ID 的查询还需要 创作者类型 参数。 |
| 创作者名称 | string | 按创作者名称搜索。如果未提供 Enum.CreatorType，则仅搜索用户。 |
| 光标 | string | 每个搜索响应都包含 nextPageCursor（如果有下一页）和 previousPageCursor（如果有上一页）。在下一个查询的光标参数中传递这些值中的任意一个，以获取结果的下一页或上一页。如果其他查询参数保持不变，则光标是有效的。 |
| 类型 | byte | 指定搜索的类型。过滤类型的推荐方法是匹配目录页面的 URL。 1 = 镇和城市 2 = 中世纪 3 = 科幻 4 = 战斗 5 = 恐怖 6 = 海军 7 = 冒险 8 = 体育 9 = 喜剧 10 = 西部 11 = 军事 13 = 建筑 14 = FPS 15 = RPG |
| 关键词 | string | 标准关键词搜索。 |
| 限制 | int | 返回的结果数量。当前值限制为 10、28 和 30。 |
| 最高价格 | int | 查询中项目的最高价格（以 Robux 为单位）。 |
| 最低价格 | int | 查询中项目的最低价格（以 Robux 为单位）。 |
| 排序聚合 | byte | 1 = 过去一天 3 = 过去一周 4 = 过去一个月 5 = 所有时间 |
| 排序类型 | byte | 0 = 相关性（默认） 1 = 收藏 2 = 销售 3 = 更新 4 = 价格升序 5 = 价格降序 |
| 子类别 | byte | 0 = 推荐 1 = 所有 2 = 收藏品 3 = 服装 4 = 身体部件 5 = 装备 9 = 帽子 10 = 脸 12 = 衬衫 13 = T 恤 14 = 裤子 15 = 头 19 = 配件 20 = 发饰 21 = 面部配件 22 = 脖部配件 23 = 肩部配件 24 = 前部配件 25 = 后部配件 26 = 腰部配件 27 = 角色动画 37 = 套装 38 = 动画套装 39 = 表情动画 40 = 社区创作 41 = 近战 42 = 远程 43 = 爆炸 44 = 加成 45 = 导航 46 = 音乐 47 = 社交 48 = 建筑 49 = 交通 54 = 头部配件 55 = 经典 T 恤 56 = 经典衬衫 57 = 经典裤子 58 = T 恤配件 59 = 衬衫配件 60 = 裤子配件 61 = 外套配件 62 = 毛衣配件 63 = 短裤配件 64 = 鞋子套装 65 = 连衣裙和裙子配件 66 = 动态头 |
以下 URL 将搜索创建者为 Roblox 的按所有时间（“排序聚合”）和相关性（“排序类型”）排序的“配件”中的前 10 个“装备”物品：
响应字段
API 响应以 JSON 格式返回。响应在 data 键中提供资产详细信息，使用以下字段：
| 字段 | 描述 |
|---|---|
| assetType | 以下资产类型值之一（仅在该项目是资产时返回）。 2 = T 恤 8 = 帽子 11 = 衬衫 12 = 裤子 17 = 头 18 = 脸 19 = 装备 25 = 手臂 26 = 腿 27 = 身体 28 = 右臂 29 = 左臂 30 = 左腿 31 = 右腿 41 = 发饰 42 = 面部配件 43 = 脖部配件 44 = 肩部配件 45 = 前部配件 46 = 后部配件 47 = 腰部配件 48 = 攀爬动画 49 = 死亡动画 50 = 摔倒动画 51 = 待机动画 52 = 跳跃动画 53 = 跑步动画 54 = 游泳动画 55 = 行走动画 56 = 姿势动画 61 = 表情动画 |
| bundleType | 捆绑类型 ID（仅在该项目是捆绑时返回）。可能的值为 BodyParts 和 AvatarAnimations。 |
| creatorName | 创作者的名称。 |
| creatorTargetId | 创作者的 ID。 |
| creatorType | 项目的创作者类型。 |
| description | 项目描述。 |
| favoriteCount | 项目的收藏数量。 |
| genres | 项目的类型列表。可能的值包括 All、Tutorial、Scary、TownAndCity、War、Funny、Fantasy、Adventure、SciFi、Pirate、FPS、RPG、Sports、Ninja 和 WildWest。 |
| id | 项目的 ID。 |
| itemRestrictions | 项目的限制列表。可能的值包括 ThirteenPlus、LimitedUnique、Limited 和 Rthro。 |
| itemStatus | 项目的状态标志列表。可能的值包括 New、Sale、XboxExclusive、AmazonExclusive、GooglePlayExclusive、IosExclusive 和 SaleTimer。 |
| itemType | 项目类型。可能的值为 Asset 或 Bundle。 |
| lowestPrice | 项目的最低转售价格（仅在该项目可转售时返回）。 |
| name | 项目名称。 |
| price | 项目的挂牌价格（如果项目可转售，则当前价格可能不同）。 |
| priceStatus | 未在售项目的价格状态。可能的值为 Free、OffSale 或 NoResellers。 |
| purchaseCount | 项目的购买数量。 |
| unitsAvailableForConsumption | 有限唯一项目的可消费单位。 |
以下是单个项目的预期返回结果示例：
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"不安灵魂头巾",
"description":"这条头巾不会帮助你与鬼魂融为一体，但至少你会很时尚。",
"productId":41270974,
"genres":[
"Scary",
"Adventure"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"User",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}