Você pode pesquisar os ativos do Roblox fora do Studio acessando a API do Creator Store. Use a API do Creator Store para consultar ativos do Studio, como malhas, modelos e áudio, e a API do Marketplace para consultar ativos de avatar no Marketplace.
Cada API requer uma URL e parâmetros de pesquisa personalizados para esse catálogo específico. Se tanto a URL quanto os parâmetros forem válidos, a API retorna um formato JSON com os resultados de sua busca.
API do Creator Store
Para informações sobre como fazer chamadas para a API do Creator Store para pesquisa, consulte o Serviço Toolbox na referência do Open Cloud.
API do Marketplace
Você pode consultar itens de avatar do Marketplace usando a seguinte URL: `https://catalog.roblox.com/v1/search/items/details?[params]``
Você pode substituir [params] pelos parâmetros de consulta apropriados para personalizar sua pesquisa.
Parâmetros de consulta
Você pode especificar parâmetros de pesquisa anexando uma série de parâmetros e valores à URL, cada um separado por um &.
Use os seguintes parâmetros para consultar o Marketplace:
| Parâmetro | Tipo | Opções e Valores |
|---|---|---|
| Categoria | byte | 0 = Em destaque 1 = Todos 2 = Colecionáveis 3 = Roupas 4 = Partes do Corpo 5 = Equipamentos 11 = Acessórios 12 = Animações de Avatar 13 = Criações da Comunidade |
| TipoDeCriador | byte | 1 = Usuário 2 = Grupo Consultas usando TipoDeCriador também requerem o parâmetro IdAlvoDoCriador. |
| IdAlvoDoCriador | long | O ID do usuário ou grupo dependendo do TipoDeCriador fornecido. Consultas usando IdAlvoDoCriador também requerem o parâmetro TipoDeCriador. |
| NomeDoCriador | string | Pesquise pelo nome do criador. Se Enum.TipoDeCriador não for fornecido, a pesquisa é apenas para usuários. |
| Cursor | string | Cada resposta de pesquisa contém um próximoCursorDaPágina se houver uma próxima página e cursorDaPáginaAnterior se houver uma página anterior. Passe qualquer um desses valores no parâmetro Cursor de sua próxima consulta para obter a próxima ou a página anterior de resultados. O cursor é válido se os outros parâmetros de consulta permanecerem os mesmos. |
| Gêneros | byte | Especifica o gênero para a pesquisa. A abordagem recomendada para filtrar por gêneros é combinar a URL de uma página de catálogo. 1 = Cidade e Vila 2 = Medieval 3 = Ficção Científica 4 = Luta 5 = Horror 6 = Naval 7 = Aventura 8 = Esportes 9 = Comédia 10 = Faroeste 11 = Militar 13 = Construção 14 = FPS 15 = RPG |
| PalavraChave | string | Pesquisa padrão por palavra-chave. |
| Limite | int | Número de resultados a retornar. Os valores atualmente são limitados a 10, 28 e 30. |
| PreçoMáximo | int | O preço máximo em Robux dos itens na consulta. |
| PreçoMínimo | int | O preço mínimo em Robux dos itens na consulta. |
| AgregaçãoDeOrdenação | byte | 1 = Último Dia 3 = Última Semana 4 = Último Mês 5 = Todos os Tempos |
| TipoDeOrdenação | byte | 0 = Relevância (Padrão) 1 = Favoritado 2 = Vendas 3 = Atualizado 4 = PreçoCrescente 5 = PreçoDecrescente |
| Subcategoria | byte | 0 = Em destaque 1 = Todos 2 = Colecionáveis 3 = Roupas 4 = Partes do Corpo 5 = Equipamentos 9 = Chapéus 10 = Faces 12 = Camisas 13 = Camisetas 14 = Calças 15 = Cabeças 19 = Acessórios 20 = Acessórios para Cabelo 21 = Acessórios para o Rosto 22 = Acessórios para o Pescoço 23 = Acessórios para o Ombro 24 = Acessórios Frontais 25 = Acessórios Traseiros 26 = Acessórios para a Cintura 27 = Animações de Avatar 37 = Pacotes 38 = Pacotes de Animação 39 = Animações de Emote 40 = Criações da Comunidade 41 = Corpo-a-Corpo 42 = A Distância 43 = Explosivo 44 = Poder 45 = Navegação 46 = Musical 47 = Social 48 = Construção 49 = Transporte 54 = Acessórios para a Cabeça 55 = Camisetas Clássicas 56 = Camisas Clássicas 57 = Calças Clássicas 58 = Acessórios de Camiseta 59 = Acessórios de Camisa 60 = Acessórios de Calças 61 = Acessórios de Jaqueta 62 = Acessórios de Suéter 63 = Acessórios de Shorts 64 = Pacotes de Sapatos 65 = Acessórios de Saia de Vestido 66 = Cabeças Dinâmicas |
A seguinte URL buscará os primeiros 10 itens "Equipamento" em "Acessórios" classificados por todos os tempos ("AgregaçãoDeOrdenação") e relevância ("TipoDeOrdenação") criados pelo Roblox ("IdAlvoDoCriador" e "TipoDeCriador"):
Campos da resposta
As respostas da API retornam em um formato JSON. A resposta fornece detalhes do ativo na chave data usando os seguintes campos:
| Caminho | Descrição |
|---|---|
| tipoDeAtivo | Um dos seguintes valores de tipo de ativo (somente retornado se o item for um ativo). 2 = Camiseta 8 = Chapéu 11 = Camisa 12 = Calças 17 = Cabeça 18 = Rosto 19 = Equipamento 25 = Braços 26 = Pernas 27 = Tronco 28 = Braço Direito 29 = Braço Esquerdo 30 = Perna Esquerda 31 = Perna Direita 41 = Acessório de Cabelo 42 = Acessório de Rosto 43 = Acessório de Pescoço 44 = Acessório de Ombro 45 = Acessório Frontal 46 = Acessório Traseiro 47 = Acessório de Cintura 48 = Animação de Escalada 49 = Animação de Morte 50 = Animação de Queda 51 = Animação de Idle 52 = Animação de Salto 53 = Animação de Corrida 54 = Animação de Natação 55 = Animação de Caminhada 56 = Animação de Pose 61 = Animação de Emote |
| tipoDePacote | O ID do tipo de pacote (somente retornado se o item for um pacote). Os valores possíveis são PartesDoCorpo e AnimaçõesDeAvatar. |
| nomeDoCriador | O nome do criador. |
| idAlvoDoCriador | O ID do criador. |
| tipoDeCriador | O tipo de criador do item. |
| descrição | A descrição do item. |
| contagemFavoritos | A contagem de favoritos de um item. |
| gêneros | Lista dos gêneros do item. Os valores possíveis incluem Todos, Tutorial, Assustador, Cidade e Vila, Guerra, Engraçado, Fantasia, Aventura, Ficção Científica, Pirata, FPS, RPG, Esportes, Ninja e Faroeste. |
| id | O ID do item. |
| restriçõesDoItem | Lista das restrições do item. Os valores possíveis incluem TrezeMais, LimitadoÚnico, Limitado e Rthro. |
| statusDoItem | Lista das bandeiras de status do item. Os valores possíveis incluem Novo, EmVenda, ExclusivoXbox, ExclusivoAmazon, ExclusivoGooglePlay, ExclusivoIos e CronômetroDeVenda. |
| tipoDoItem | O tipo do item. Os valores possíveis são Ativo ou Pacote. |
| preçoMaisBaixo | O preço mais baixo de revenda do item (somente retornado se o item for revendável). |
| nome | O nome do item. |
| preço | O preço de listagem do item (o preço atual pode diferir se o item for revendável). |
| statusDoPreço | O status do preço de um item que não está à venda. Os valores possíveis incluem Gratuito, ForaDeVenda ou SemRevenda. |
| contagemDeCompras | A contagem de compras de um item. |
| unidadesDisponíveisParaConsumo | A unidade disponível para consumo de um item limitado único. |
A seguir está um exemplo de retorno esperado para um único item:
{
"keyword": null,
"previousPageCursor": null,
"nextPageCursor": "2_1_c541d05046b5c1c78a5d386b5e302243",
"data": [
{
"id":527373900,
"itemType":
"Asset",
"assetType":42,
"name":"Bandana Almas Inquietas",
"description":"Esta bandana não ajudará você a se misturar com fantasmas, mas pelo menos você estará estiloso.",
"productId":41270974,
"genres":[
"Assustador",
"Aventura"
],
"itemStatus":[],
"itemRestrictions":[],
"creatorType":"User",
"creatorTargetId":1,
"creatorName":"Roblox",
"price":300,
"favoriteCount":15943,
"offSaleDeadline":null
}
]
}