外部カタログクエリ

外部カタログ API にアクセスすることにより、Studio 以外の Roblox のアセットを検索できます。 クリエーターマーケットプレイス APIを使用して、メッシュ、モデル、オーディオなどの Studio アセットをクエリし、マーケットプレイス APIを使用して、マーケットプレイスのアバターアセットをクエリします。

各 API には、その特定のカタログの URL とカスタム検索パラメータが必要です。 URL とパラメータの両方が有効である場合、API は検索結果を含む JSON 形式を返します。

クリエーターマーケットプレイス API

クリエーターマーケットプレースカタログからアイテムをクエリするには、以下の URL を使用します。 https://search.roblox.com/catalog/json?[params]

を適切なクエリパラメータ[params]に置き換えて、検索をカスタマイズできます。

クエリパラメータ

URL に一連のパラメータと値を追加することで、検索パラメータを指定できます&。

クリエーターマーケットプレイスカタログをクエリするには、以下のパラメータを使用します。

以下の URL は、「モデル」サブカテゴリの 10 個のアイテムを検索します。

https://search.roblox.com/catalog/json?Category=6&SortType=3&ResultsPerPage=10

応答フィールド

API 応答は JSON 形式で返されます。 応答は、以下のプライマリフィールドでアセットの詳細を提供します。

以下は、単一のアイテムに対する期待される戻り出力の例です。

{
    "AssetId": 3374795585,
    "Name": "Rat",
    "Description": "",
    "AbsoluteUrl": "https://www.roblox.com/catalog/3374795585/Rat",
    "Price": "",
    "Updated": "8 months ago",
    "Favorited": "80 times",
    "Sales": "1,613",
    "Remaining": "",
    "Creator": "ROBLOX",
    "CreatorAbsoluteUrl": "https://www.roblox.com/users/1/profile",
    "PrivateSales": "",
    "PriceView": 0,
    "BestPrice": "",
    "ContentRatingTypeID": 0,
    "IsServerSideThumbnailLookupInCatalogEnabled": true,
    "AudioUrl": null,
    "IsLargeItem": false,
    "IsThumbnailFinal": true,
    "IsThumbnailUnapproved": false,
    "ThumbnailUrl": "https://t1.rbxcdn.com/745a4be8c2366db2e55d0a67678434dc",
    "BcOverlayUrl": null,
    "LimitedOverlayUrl": null,
    "DeadlineOverlayUrl": null,
    "LimitedAltText": null,
    "NewOverlayUrl": null,
    "SaleOverlayUrl": null,
    "IosOverlayUrl": null,
    "XboxOverlayUrl": null,
    "GooglePlayOverlayUrl": null,
    "AmazonOverlayUrl": null,
    "IsTransparentBackground": false,
    "IsNewRobuxIconEnabled": true,
    "AssetTypeID": 10,
    "CreatorID": 1,
    "CreatedDate": "/Date(1561635090927)/",
    "UpdatedDate": "/Date(1562003916210)/",
    "IsForSale": false,
    "IsPublicDomain": true,
    "IsLimited": false,
    "IsLimitedUnique": false,
    "MinimumMembershipLevel": 0,
    "OffSaleDeadline": null,
    "ProductId": 586905093
}

マーケットプレイス API

マーケットプレイスからアバターアイテムを検索するには、以下の URL を使用します。 https://catalog.roblox.com/v2/search/items/details?[params]

を適切なクエリパラメータ[params]に置き換えて、検索をカスタマイズできます。

クエリパラメータ

URL に一連のパラメータと値を追加することで、検索パラメータを指定できます&。

マーケットプレイスをクエリするには、以下のパラメータを使用します。

以下の URL は、Roblox（「CreatorTargetID」）によって作成されたオールタイム（「SortAggregation」）と関連性（「SortType」）でソートされた最初の 10 個の「ギア」アイテムを検索します。

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

応答フィールド

API 応答は JSON 形式で返されます。 応答は、以下のフィールドを使用して、キdataーにアセットの詳細を提供します。

以下は、単一のアイテムに対する期待される戻り出力の例です。

{
    "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
        }
    ]
}