Consultas al catálogo externas

Puedes buscar los recursos de Roblox fuera de Studio al acceder a la API externa del catálogo. Usar la API del mercado de creadores para realizar consultas de recursos de Studio, como mallas, modelos y audio, y la API del mercado para hacer consultas de recursos de avatares en el mercado.

Cada API requiere una URL y parámetros de búsqueda personalizados para el catálogo específico. Si tanto la URL como los parámetros son válidos, la API devuelve los resultados de la búsqueda en formato JSON.

API del mercado de creadores

Puedes consultar artículos del catálogo del mercado de creadores usando la siguiente URL: https://search.roblox.com/catalog/json?[params]

Puedes reemplazar [params] por los parámetros de consulta adecuados para personalizar tu búsqueda.

Parámetros de la consulta

Puedes especificar los parámetros de búsqueda al añadirle una serie de parámetros y valores a la URL, cada uno separado por &.

Usa los siguientes parámetros para realizar consultas en el catálogo del mercado de creadores:

Con la siguiente URL se buscarán diez artículos en la subcategoría “Modelos”, ordenados en función de su actualización más reciente.

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

Campos de respuesta

Las respuestas de la API se devuelven en formato JSON y proporcionan detalles del recurso con los siguientes campos primarios: La respuesta proporciona detalles del recurso con los siguientes campos primarios:

A continuación, se muestra un ejemplo de la salida prevista para un solo artículo:

{
    "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 del mercado

Puedes consultar objetos de avatares del Mercado usando la siguiente URL: https://catalog.roblox.com/v2/search/items/details?[params]

Puedes reemplazar [params] por los parámetros de consulta adecuados para personalizar tu búsqueda.

Parámetros de la consulta

Puedes especificar los parámetros de búsqueda al añadirle una serie de parámetros y valores a la URL, cada uno separado por &.

Usa los siguientes parámetros para realizar consultas en el mercado:

Con la siguiente URL, se buscarán los primeros diez artículos de “Equipamiento” ordenados por relevancia (“SortType”) de todos los tiempos (“SortAggregation”) creados por Roblox (“CreatorTargetID”):

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

Campos de respuesta

Las respuestas de la API se devuelven en formato JSON y proporcionan detalles del recurso con los siguientes campos primarios: Las respuestas de la API se devuelven en formato JSON y proporcionan detalles del recurso en la clave data con los siguientes campos:

A continuación, se muestra un ejemplo de la salida prevista para un solo artículo:

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