Puedes buscar los activos de Roblox fuera de Studio accediendo a la API de la tienda de creadores. Usa la API de la tienda de creadores para consultar activos de Studio, como mallas, modelos y audio, y la API del mercado para consultar activos de avatar en el mercado.
Cada API requiere una URL y parámetros de búsqueda personalizados para ese catálogo específico. Si tanto la URL como los parámetros son válidos, la API devuelve un formato JSON con los resultados de tu búsqueda.
API de la tienda de creadores
Para información sobre cómo hacer llamadas a la API de la tienda de creadores para búsquedas, consulta el servicio Toolbox en la referencia de Open Cloud.
API del mercado
Puedes consultar elementos de avatar del mercado usando la siguiente URL: `https://catalog.roblox.com/v1/search/items/details?[params]``
Puedes reemplazar [params] con los parámetros de consulta apropiados para personalizar tu búsqueda.
Parámetros de consulta
Puedes especificar parámetros de búsqueda agregando una serie de parámetros y valores a la URL, cada uno separado por un &.
Utiliza los siguientes parámetros para consultar el mercado:
| Parámetro | Tipo | Opciones y valores |
|---|---|---|
| Categoría | byte | 0 = Destacado 1 = Todos 2 = Coleccionables 3 = Ropa 4 = Partes del cuerpo 5 = Equipamiento 11 = Accesorios 12 = Animaciones del avatar 13 = Creaciones de la comunidad |
| TipoCreador | byte | 1 = Usuario 2 = Grupo Las consultas que utilizan TipoCreador también requieren el parámetro IdObjetivoCreador. |
| IdObjetivoCreador | long | El ID del usuario o grupo dependiendo del TipoCreador proporcionado. Las consultas que utilizan IdObjetivoCreador también requieren el parámetro TipoCreador. |
| NombreCreador | string | Buscar por nombre de creador. Si Enum.TipoCreador no se proporciona, la búsqueda es solo para usuarios. |
| Cursor | string | Cada respuesta de búsqueda contiene un nextPageCursor si hay una página siguiente y previousPageCursor si hay una página anterior. Pasa cualquiera de estos valores en el parámetro Cursor de tu próxima consulta para obtener la siguiente o anterior página de resultados. El cursor es válido si los otros parámetros de consulta permanecen iguales. |
| Géneros | byte | Especifica el género para la búsqueda. El enfoque recomendado para filtrar por géneros es hacer coincidir la URL de una página de catálogo. 1 = Ciudad y pueblo 2 = Medieval 3 = Ciencia ficción 4 = Lucha 5 = Horror 6 = Naval 7 = Aventura 8 = Deportes 9 = Comedia 10 = Oeste 11 = Militar 13 = Construcción 14 = FPS 15 = RPG |
| PalabraClave | string | Búsqueda estándar por palabra clave. |
| Límite | int | Numero de resultados a devolver. Los valores están actualmente limitados a 10, 28 y 30. |
| PrecioMáximo | int | El precio máximo en Robux de los ítems en la consulta. |
| PrecioMínimo | int | El precio mínimo en Robux de los ítems en la consulta. |
| ClasificaciónAgregación | byte | 1 = Último día 3 = Última semana 4 = Último mes 5 = Tiempo total |
| TipoClasificación | byte | 0 = Relevancia (Predeterminado) 1 = Favoritos 2 = Ventas 3 = Actualizado 4 = PrecioAscendente 5 = PrecioDescendente |
| Subcategoría | byte | 0 = Destacado 1 = Todos 2 = Coleccionables 3 = Ropa 4 = Partes del cuerpo 5 = Equipamiento 9 = Sombreros 10 = Rostros 12 = Camisas 13 = Camisetas 14 = Pantalones 15 = Cabezas 19 = Accesorios 20 = Accesorios para el cabello 21 = Accesorios para la cara 22 = Accesorios para el cuello 23 = Accesorios para el hombro 24 = Accesorios frontales 25 = Accesorios para la espalda 26 = Accesorios para la cintura 27 = Animaciones del avatar 37 = Paquetes 38 = Paquetes de animaciones 39 = Animaciones de emoticonos 40 = Creaciones de la comunidad 41 = Cuerpo a cuerpo 42 = A distancia 43 = Explosivo 44 = Poder 45 = Navegación 46 = Musical 47 = Social 48 = Construcción 49 = Transporte 54 = Accesorios para la cabeza 55 = Camisetas clásicas 56 = Camisas clásicas 57 = Pantalones clásicos 58 = Accesorios de camisetas 59 = Accesorios de camisas 60 = Accesorios de pantalones 61 = Accesorios de chaquetas 62 = Accesorios de suéteres 63 = Accesorios de pantalones cortos 64 = Paquetes de zapatos 65 = Accesorios de falda de vestido 66 = Cabezas dinámicas |
La siguiente URL buscará los primeros 10 ítems de "Equipamiento" en "Accesorios" ordenados por todo el tiempo ("ClasificaciónAgregación") y relevancia ("TipoClasificación") creados por Roblox ("IdObjetivoCreador" y "TipoCreador"):
Campos de respuesta
Las respuestas de la API se devuelven en un formato JSON. La respuesta proporciona detalles del activo en la clave data usando los siguientes campos:
| Campo | Descripción |
|---|---|
| tipoActivo | Uno de los siguientes valores de tipo de activo (solo devuelto si el ítem es un activo). 2 = Camiseta 8 = Sombrero 11 = Camisa 12 = Pantalones 17 = Cabeza 18 = Rostro 19 = Equipamiento 25 = Brazos 26 = Piernas 27 = Torso 28 = Brazo derecho 29 = Brazo izquierdo 30 = Pierna izquierda 31 = Pierna derecha 41 = Accesorio para el cabello 42 = Accesorio para la cara 43 = Accesorio para el cuello 44 = Accesorio para el hombro 45 = Accesorio frontal 46 = Accesorio trasero 47 = Accesorio para la cintura 48 = Animación de escalada 49 = Animación de muerte 50 = Animación de caída 51 = Animación de inactividad 52 = Animación de salto 53 = Animación de carrera 54 = Animación de natación 55 = Animación de caminar 56 = Animación de pose 61 = Animación de emoticono |
| tipoPaquete | El ID de tipo de paquete (solo devuelto si el ítem es un paquete). Los valores posibles son Partes del cuerpo y Animaciones del avatar. |
| nombreCreador | El nombre del creador. |
| idObjetivoCreador | El ID del creador. |
| tipoCreador | El tipo de creador del ítem. |
| descripción | La descripción del ítem. |
| conteoFavoritos | El conteo de favoritos de un ítem. |
| géneros | Lista de géneros del ítem. Los valores posibles incluyen Todo, Tutorial, Espeluznante, Ciudad y pueblo, Guerra, Divertido, Fantasía, Aventura, Ciencia ficción, Pirata, FPS, RPG, Deportes, Ninja, y Oeste salvaje. |
| id | El ID del ítem. |
| restriccionesÍtem | Lista de restricciones del ítem. Los valores posibles incluyen TreintaMás, LimitadoÚnico, Limitado, y Rthro. |
| estadoÍtem | Lista de banderas de estado del ítem. Los valores posibles incluyen Nuevo, En Venta, Exclusivo de Xbox, Exclusivo de Amazon, Exclusivo de Google Play, Exclusivo de iOS, y Temporizador de Venta. |
| tipoÍtem | El tipo de ítem. Los valores posibles son Activo o Paquete. |
| precioMásBajo | El precio más bajo de reventa del ítem (solo devuelto si el ítem es revendible). |
| nombre | El nombre del ítem. |
| precio | El precio de listado del ítem (el precio actual puede diferir si el ítem es revendible). |
| estadoPrecio | El estado del precio de un ítem que no está en venta. Los valores posibles son Gratis, Fuera de Venta, o Sin Revendedores. |
| conteoCompras | El conteo de compras de un ítem. |
| unidadesDisponiblesParaConsumo | La unidad disponible para el consumo de un ítem limitado único. |
A continuación se muestra un ejemplo de la salida esperada para un solo ítem:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Bandana de almas inquietas",
"description":"Esta bandana no te ayudará a mezclarte con los fantasmas, pero al menos estarás a la moda.",
"productId":41270974,
"genres":[
"Espeluznante",
"Aventura"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"User",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}