As a Roblox developer, it is currently too hard to integrate the looks API into games as there is no native engine support or open cloud support for it at the moment. The only way to use it to my knowledge is to create a web server for it which I already did, but most people do not have the resources for this. A web server is also incredibly inconvenient as the looks API requires several steps to use and paired with low rate limits, this is very difficult without proxies. If one IP address handled thousands of players using this proxy web server… basically no one would be able to use it.
First of all, all these endpoints require authentication with a valid .ROBLOSECURITY cookie which could expire due to the lack of API key support (at least I was unable to find an API key scope that worked with this). The first request has 120 uses per minute which will be consumed very quickly, the other request also has 300 uses per minute, although for some reason an IPv6 proxy gives me 20,000 uses per minute. That endpoint only returns lookIds which cannot be used inside the engine, so you need to send a post request to the hydrate API to extract the outfitIds from these lookIds which takes up two requests as you need to make a post request just to fetch the required x-csrf-token and then another request just to retrieve the data. Not to mention that this can give 10 results, 50 results or NO results at all which could be a bigger waste. I have recently been playing with the looks API and I think it has a lot of potential to be used in avatar shopping games since as far as I know, not many developers are aware of this API.
If Roblox is able to address this issue, it would improve my development experience because this would allow me to integrate this API into games which I believe could encourage spending and boost discovery of avatar items that pair well. I have had a lot of enjoyment reverse engineering this API and it makes me sad to see that this useful tool seems to have been forgotten under the radar, I only figured out how to use this because I intercepted my Roblox app since it is basically undocumented, I even reported a bug related to them when Roblox Plus came out which proves how forgotten this feature was. Not only can the looks API generate decent avatars, it also seems to produce new results every hour which is even better for discovery since countless items are buried under a lack of sorting options (PLEASE ADD TIME RANGE FILTERS TO CatalogSearchParams).
Resources
This endpoint will return a mix of user generated avatars as well as auto generated avatars that may be based on existing avatars. You can detect the Roblox generated ones if they are named
Roblox Curated Outfit
https://apis.roblox.com/marketplace-widgets/v1/widgets?query=rick%20sanchez&context=avatarTab
x-ratelimit-limit: 60, 10000;w=60, 60;w=60This alternate endpoint is supposed to only return auto generated avatars, but sometimes it will not return any results. It will also sometimes cache the wrong set of items and return the results above instead, not sure if this is a bug tho. You will know if the correct results were generated if the curator is Roblox and they are named random words instead of
Roblox Curated Outfit
https://apis.roblox.com/marketplace-widgets/v1/widgets/search?query=autumn
x-ratelimit-limit: 60, 10000;w=60, 60;w=60
This endpoint is POST and requires a csrf token will convert the lookIds into outfitIds which can be read in engine
https://apis.roblox.com/marketplace-widgets/v1/widgets/hydrate
x-ratelimit-limit: 300, 50000;w=60, 300;w=60
Examples
autumn
cute moe goth y2k scene vkei emo girl
tuxedo
black, leather, jacket, goth, edgy
