Puedes buscar los recursos de Roblox fuera de Studio accediendo a la API de la Tienda de creadores.Usa la API de la tienda de creadores para consultar los recursos de Studio, como mallas, modelos y sonido, audio, y la API de mercado para consultar los recursos de avatares 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 buscar.
API de la tienda de creadores
Para obtener información sobre cómo realizar llamadas a la API de la Tienda del Creador para la buscar, consulte el servicio de caja de herramientas en la referencia de Open Cloud.
API de mercado
Puedes consultar los artículos de avatar del mercado utilizando la siguiente URL: https://catalog.roblox.com/v1/search/items/details?[params]
Puedes reemplazar con los parámetros de consulta apropiados para personalizar tu buscar.
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 &.
Usa los siguientes parámetros para consultar el Mercado:
| Parámetro | Tipo | Opciones y valores |
|---|---|---|
| Categoría | octava | = Destacado = Todo = Coleccionables = Ropa = Partes del cuerpo = Equipamiento = Accesorios = Animaciones de avatares = Creaciones de la comunidad = Gear = Accesorios > = Animaciones de avatares comunitarias |
| Tipo de creador | octava | 1 = Usuario 2 = Grupo |
| Nombre del creador | cadena | Buscar por nombre de creador. Si no se proporciona Enum.CreatorType, la búsqueda es solo para usuarios. |
| Id de objetivo creador | larga | El ID de usuario o grupo dependiendo del tipo de creador proporcionado. |
| Cursores | cadena | Cada respuesta de búsqueda contiene un nextPageCursor si hay una página siguiente y un 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 se mantienen iguales. |
| Géneros | octava | Specifica el género para la buscar.El enfoque recomendado para filtrar en géneros es coincidir con la URL de una página de catálogo. = Ciudad y ciudad = Medieval = SciFi = Combate = Horror = Naval = Aventura = Deportes = Comedia = Militar = Construcción = FPS = RPG |
| Palabra clave | cadena | buscarde palabra clave estándar. |
| Límite | intento | Número de resultados para devolver. Los valores están actualmente limitados a 10, 28 y 30. |
| Precio máximo | intento | El precio máximo en Robux de los artículos en la consulta. |
| Precio mínimo | intento | El precio mínimo en Robux de los artículos en la consulta. |
| Ordenar agregación | octava | 1 = Día pasado 3 = Semana pasada 4 = Mes pasado 5 = Todo el tiempo |
| Tipo de clasificación | octava | 0 = Relevancia (Por defecto) 1 = Favoritos 2 = Ventas 3 = Actualizado 4 = Precio ascendente 5 = Precio descendente = actualizado |
| Subcategoría | octava | English: Español No hay resultados Español |
La siguiente URL buscará los primeros 10 artículos de "Equipo" en "Accesorios" ordenados por todos los tiempos ("Ordenar agregación") y relevancia ("Tipo de clasificación") creados por Roblox ("CreatorTargetId":
https://catalog.roblox.com/v1/search/items/details?Category=11&Subcategory=5&CreatorTargetId=1&SortType=0&SortAggregation=5&Limit=10
Campos de respuesta
Las respuestas de la API se devuelven en formato JSON. La respuesta proporciona detalles de activos en la clave data usando los siguientes campos:
| Campo | Descripción |
|---|---|
| tipo de activo | Uno de los siguientes valores de tipo de activo (solo se devuelve si el artículo es un activo). = Camiseta = Sombrero = Camisa = Pantalones = Gorro = Equipamiento = Brazo derecho = Brazo izquierdo = Cara = Accesorio de cabeza = Accesorio de cara = Animation de muerte = Animación de caída = Animación de salto = Animación de carrera = Accesorio de cabeza = Emote = Emote = Accesorio de cabeza = Accesorio de cabeza = Animation de carrera = Accesorio de cabeza = Accesorio de cabeza = Accesorio de cabeza = Accesorio de cabeza = Accesoria de cabeza = Accesoria de cabeza = Accesoria de cabeza = Accesoria de cabeza = Accesoria = Accesoria de cabeza = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesoria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria = Accesaria |
| tipo de paquete | El ID del tipo de paquete (solo se devuelve si el artículo es un paquete). Los valores posibles son BodyParts y AvatarAnimations . |
| nombre del creador | El nombre del creador. |
| objetivo de creadorId | La identificación del creador. |
| tipo de creador | El introducirde creador del objeto. |
| descripción | La descripción del artículo. |
| favoriteCount | El recuento favorito de un objeto. |
| géneros | Lista de los géneros del objeto.Los valores posibles incluyen All , Tutorial , Scary , TownAndCity , War , Funny , Fantasy , Adventure , SciFi , Pirate , FPS , RPG , Sports , Ninja , y WildWest . |
| id | El ID del objeto. |
| restricciones de artículo | Lista de restricciones del objeto. Los valores posibles incluyen ThirteenPlus , LimitedUnique , Limited , y Rthro . |
| estado del artículo | Lista de las banderas de estado del objeto.Los valores posibles incluyen New , Sale , XboxExclusive , AmazonExclusive , GooglePlayExclusive , IosExclusive , y SaleTimer . |
| tipo de elemento | El introducirartículo. Los valores posibles son Asset o Bundle . |
| precio más bajo | El precio de reventa más bajo del artículo (solo se devuelve si el artículo es reutilizable). |
| nombre | El nombre del artículo. |
| precio | El precio de lista del artículo (el precio actual puede diferir si el artículo es reutilizable). |
| estado de precio | El estado de precio de un artículo que no está en venta. Los valores posibles son Free , OffSale o NoResellers . |
| compraCount | El número de compra de un objeto. |
| unidades disponibles para el consumo | La unidad disponible para consumir un objetoúnico limitado. |
A continuación se muestra un ejemplo de salida de devolución esperada para un solo objeto:
{
"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
}
]
}