AvatarEditorService Catalog methods [Public Release]

Updates Announcements
#1

Hello Developers,

We have previously released the avatar editing functionality of AvatarEditorService and many developers have been wondering when the catalog-related functionality would be released.

Good news! We are excited to announce that the catalog functionality of AvatarEditorService has exited beta and is now available to all developers! These methods allow you to search the catalog in your experience, along with getting recommendations or getting the details of items.

Here are the methods that are being released:

  • AvatarEditorService:SearchCatalog()
  • AvatarEditorService:GetBatchItemDetails()
  • AvatarEditorService:GetRecommendedAssets()
  • AvatarEditorService:GetRecommenedBundles()
  • AvatarEditorService:GetItemDetails()
  • AvatarEditorService:PromptSetFavorite()
  • AvatarEditorService:GetFavorite()

Now all the methods of AvatarEditorService have been released! For a full list of methods and further documentation, see the documentation here.

For some information on using these methods, please check out the Avatar Editor Service Tutorial.

Samples

We have produced some samples to show how these AvatarEditorService APIs can be used.

Here is a simple AvatarEditor that demonstrates how these APIs are used:

We also have an older version of the app avatar editor adapted to work in experience using these APIs. This might also be a useful reference to see how these APIs can be used.

Screen Shot 2021-08-24 at 9.55.39 PM
Screen Shot 2021-08-24 at 9.55.39 PM1138×579 132 KB

Implementing an Avatar Editor in your experience can allow you to benefit from the 40% affiliate fee when users purchase catalog items.

In the near future, we will be adding properties to CatalogSearchParams that will allow searching by a given creator so you can use this to display only your items if desired.

Please let us know if you have any questions, concerns, or any other feature requests down below!

Thank you.

171 Likes
Super Biz Catalog V3 – Monetize With an Avatar Shop & Avatar Editor
Alternatives to HttpGet?
#2

This topic was automatically opened after 10 minutes.

#3

Woohoo! Thanks for this update, it definately streamlines a few development aspects for me!

10 Likes
#4

The days of having to use an external source to fetch catalog items seems to be coming to an end 🥹 love this update!!

14 Likes
#5

This method must be cool for us developers.

5 Likes
#6

I’m really looking forward to using this service in my experiences, but it’s disappointing that there’s still a cap of 1,000 results, just like the web endpoints & catalog search. For deeper searching, you can be surprised by how quickly you can hit this limit in the catalog.

image

As an example, I’ve been trying to find a way to get all the Gears and Roblox-made items, like how Catalog Heaven does it. I’ve struggled to do this because of this limit in place, and it seems that not many others know how to do this either.

Are there any plans to increase or remove this cap? Not just through AvatarEditorService, but on the Web as well?

Code 
local AvatarEditorService = game:GetService("AvatarEditorService")

local Params = CatalogSearchParams.new()
Params.AssetTypes = {Enum.AvatarAssetType.Gear}
Params.SortType = Enum.CatalogSortType.Relevance
Params.IncludeOffSale = true
Params.Limit = 120

local CatalogPages = AvatarEditorService:SearchCatalog(Params)

local Items = {}

while true do
	for _, ItemInfo in CatalogPages:GetCurrentPage() do
		table.insert(Items, {ItemInfo.Id, ItemInfo.Name})
	end
	
	if CatalogPages.IsFinished then
		break
	else
		while true do
			local Success, Response = xpcall(CatalogPages.AdvanceToNextPageAsync, warn, CatalogPages)
			if Success then
				print(#Items)
				break
			end
			warn(Response)
			task.wait(5)
		end
	end
end

warn("Done! # of Items: ".. #Items)

Also, a funky bug here, it seems that if I use the code shown above, but use RecentlyCreated as the SortType (I guess “Recently Updated” is being phased out), it returns nothing?

Possibly related, if you visit Roblox’s recently uploaded accessories, of which there should be thousands of them, it only shows about 18-20 for the first page. Sometimes it’ll refuse to load anything. This is including items not for sale.

8 Likes
#7

image
It seems like when I try to use the demo and save to avatar, it unequips all of my emotes. The PromptSaveAvatar method uses HumanoidDescriptions which don’t have an emote slot, but surely it should just keep the equipped emotes in their slots instead of just erasing them, right?

11 Likes
#8

AvatarEditorService:PromptSaveAvatar does support emotes through HumanoidDescription:SetEquippedEmotes(). I think this is a bug with the demo place, I will fix it.

12 Likes
#9

@TheGamer101 Bit unrelated to this feature, but are there any updates on the avatar accessory limitations that negatively impact the usecases of the avatar editor APIs? A product manager replied around the middle of last year stating that the issues were on the roadmap & were being looked into, but that was quite a while ago now.

4 Likes
#10

I’m interested in why these new APIs are beginning to return dictionaries for listed data rather than a new DataType, and I’ll explain why.

Dictionaries don’t type well with methods because they can be bulky and usually require these “ghost” types like in os.data. In this case, you guys just used any. Both have horrible UX because they don’t propagate autocomplete and can’t give type data for other variables to use.

With dedicated DataTypes, the returned types are already given and updated, and better yet, can be used in other variable types!

ScriptEditorService also has methods that suffers from this design choice (And strangely has camelCase keys which makes working with the end one difficult).

6 Likes
#11

Thank you! We’ll be adding a bunch of these new features to the Super Biz Catalog.

7 Likes
#12

Is it possible for you to just allow users in your game to find items by using AvatarEditorService:SearchCatalog rather than you needing to scrape a complete list up front?

Ideally, users can find what they are looking for far before 1000 results so hopefully users aren’t hitting this often. I think it would be good for us to support the use case of developers scraping for a list of items but we might need to do this through something other than AvatarEditorService for scalability reasons.

Thanks for your report on the recently updated gear bug. We will look into it.

6 Likes
#13

It appears that PromptRenameOutfit and PromptDeleteOutfit were not mentioned on this list, were these API also enabled?

4 Likes
#14

PromptRenameOutfit and PromptDeleteOutfit were already enabled in the past.

5 Likes
#15

I have fixed the demo experience so that it no longer removes emotes!

3 Likes
#16

This must have been silently-enabled since I previously checked and this were not the case, nice to know that they are at least enabled now, however!

One question I do have, I see the API CheckApplyDefaultClothing, would this also work if the clothing is content-deleted, I recently added HumanoidDescriptions to my experience and players were abusing this bug to appear naked on leaderboards, etc. On top of this, would it be fine to replace a custom default shirt / pants if this function returns a non-nil value? (I’m assuming it would be)

1 Like
#17

CheckApplyDefaultClothing currently doesn’t check if the items have been moderated or not. It only checks if the player has clothing equipped and if not checks if their body colors are similar. That is a good idea. For now, maybe you can try to load the shirt/pants using InsertService:LoadAsset and if it does not load then it has been moderated.

You can replace the returned default shirt/pants with a custom default shirt/pants if you want to.

3 Likes
#18

This is awesome! Thank you for this! Do you know what the current rate limits are for :SearchCatalog()? Also, the documentation has CreatorType listed as a property for CatalogSearchParams, but when testing in studio this property is not there.

1 Like
#19

Searching by creator is not yet available but will be released soon.

3 Likes
#20

Very Cool Feature for games but I wonder how many Catalog type Games where creators just recreate the catalog and sell stuff for commission will pop up

2 Likes