{"openapi":"3.1.0","info":{"title":"Habbo Hotel API","version":"1.0.0","description":"Live player profiles from Habbo, the long-running virtual-world social platform, served straight from Habbo's official public API — no key, nothing cached. Habbo has been one of the largest teen virtual worlds for two decades, built around avatars, badges, groups and player-built rooms. The user endpoint returns a player's public profile: their avatar figure, motto, online status, member-since and last-online dates, level and total experience, and their hand-picked showcase badges — for example Puhekupla, a member since 2009. The profile endpoint returns the full social graph the player has made public: their groups, their player-built rooms, and their friend and badge counts. The badges endpoint returns every badge the player has earned with its code, name and description — dedicated collectors rack up hundreds. The avatar endpoint turns a player's figure string into ready-to-use avatar image URLs at several sizes and angles, straight from Habbo's imaging service. Every hotel is supported — the international .com plus the Brazilian, German, Spanish, Finnish, French, Italian, Dutch and Turkish hotels. Everything is live from Habbo, nothing stored. This is the Habbo social layer for any fan site, badge tracker, community tool or bot. Distinct from mainstream social-network APIs — this is the Habbo virtual world: avatars, badges, groups and rooms. 5 endpoints, no key on our side.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/habbo-api","description":"oanor gateway"}],"tags":[{"name":"Habbo"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/avatar":{"get":{"operationId":"get_v1_avatar","tags":["Habbo"],"summary":"Avatar image URLs","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Player name","schema":{"type":"string"},"example":"Puhekupla"},{"name":"hotel","in":"query","required":false,"description":"Hotel code (default com)","schema":{"type":"string"},"example":"com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Puhekupla","avatar":{"full":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=l&direction=2&head_direction=2&action=std","small":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=s&direction=2&head_direction=2","headshot":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=l&headonly=1&direction=2&head_direction=3"},"figure":"hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66","source":"Habbo"},"meta":{"timestamp":"2026-06-09T11:38:26.640Z","request_id":"61adf111-5dab-443a-b31a-ec201bb87e7f"},"status":"ok","message":"Avatar retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/badges":{"get":{"operationId":"get_v1_badges","tags":["Habbo"],"summary":"Every badge a player has earned","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Player name","schema":{"type":"string"},"example":"Puhekupla"},{"name":"hotel","in":"query","required":false,"description":"Hotel code (default com)","schema":{"type":"string"},"example":"com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Puhekupla","badges":[{"code":"ACH_RegistrationDuration20","name":"100 % True Habbo XX","description":"For being a member of the community for 1825 days."},{"code":"AQR01","name":"Aquarium 1","description":"1 of 4"},{"code":"AQR02","name":"Aquarium 2","description":"2 of 4"},{"code":"ACH_TagB20","name":"Blades of glory XX","description":"For getting tagged 1284 times while ice skating."},{"code":"ACH_RoomDecoBC8","name":"Builders Club designer VIII","description":"For placing 250 Builders Club furni."},{"code":"COW01","name":"Cowboyween","description":"Trick or Treat?"},{"code":"ACH_GuideFeedbackGiver1","name":"Feedback provider","description":"For giving feedback to helpers 2 times."},{"code":"MRG00","name":"Friendship Bracelet","description":"A stranger is a friend you have yet to meet!"},{"code":"HBN05","name":"Gates of the Castle","description":"For passing the Gates of the Castle Quests"},{"code":"ACH_GuideAdvertisementReader1","name":"Gran Turismo","description":"For checking out a guided tour."},{"code":"ACH_GiftReceiver1","name":"Greet me I","description":"For receiving a gift from other people."},{"code":"MRG01","name":"Habbo Canada","description":"Remembering my Habbo roots!"},{"code":"ACH_HabboWayGraduate1","name":"Habbo Way","description":"For passing the Habbo Way quiz!"},{"code":"ACH_Citizenship1","name":"Habbo citizen","description":"For earning your citizenship."},{"code":"ACH_HappyHour1","name":"Happy hour","description":"For logging in during happy hour."},{"code":"ACH_RbTagA7","name":"Hi, roller VII","description":"My skating rink has 100 Roller Rink tiles. Oh yeah!"},{"code":"ACH_TagC13","name":"Ice ice baby XIII","description":"For ice skating for 571 minutes."},{"code":"ACH_SelfModIgnoreSeen1","name":"Ignore","description":"For being aware of ignore option"},{"code":"ACH_snowBoardBuild4","name":"King of the hill IV","description":"My snowboarding hill has 100 Snowboard Patches. Oh yeah!"},{"code":"ACH_SafetyQuizGraduate1","name":"Level I Safety tips","description":"For passing the Safety quiz!"},{"code":"ACH_TradingPass6","name":"Level jumping","description":"For reaching avatar level 6."},{"code":"ACH_AvatarLooks1","name":"Looks that kill I","description":"For changing your look for the first time."},{"code":"ACH_GuideRequester1","name":"Lost again","description":"For making 2 help requests."},{"code":"ACH_Motto1","name":"Master of Words I","description":"For editing your motto for the first time."},{"code":"ACH_TagA6","name":"Miracle of ice VI","description":"Let it go and put 80 ice patches in your room."},{"code":"ACH_RespectGiven5","name":"Nice as pie! V","description":"For giving respect 40 times."},{"code":"ACH_AllTimeHotelPresence12","name":"Online time XII - Bedrock","description":"For spending 10080 minutes in the Hotel."},{"code":"SAF07","name":"Password Champion","description":"Given to Habbos with safe and UNIQUE passwords."},{"code":"ACH_PetRespectGiver4","name":"Pet lover IV","description":"For scratching anyone's pets at least 20 times."},{"code":"UK190","name":"Puhekupla Event winner","description":"Champion chocolate snatcher"},{"code":"ACH_RespectEarned3","name":"Respected Habbo III","description":"For earning respect 16 times."},{"code":"ACH_RoomDecoHosting5","name":"Room host V","description":"For having visitors spend 90 minutes in your rooms."},{"code":"ACH_RoomEntry7","name":"Room raider VII","description":"For 250 room visits. Pilgrim."},{"code":"ACH_FriendListSize3","name":"Socializer III","description":"For having 30 friends in your friend list."},{"code":"ACH_TraderPass1","name":"Trading pass I","description":"Without a trading pass you can't trade: you have to have an account that is 1 day old and you have to verify your email."},{"code":"ACH_EmailVerification1","name":"True you","description":"For verifying your email address. Thanks!"}],"source":"Habbo","badge_count":36},"meta":{"timestamp":"2026-06-09T11:38:27.091Z","request_id":"64f8947f-0654-4b08-81cb-d25b760ce50d"},"status":"ok","message":"Badges retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/profile":{"get":{"operationId":"get_v1_profile","tags":["Habbo"],"summary":"A player's public social graph","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Player name","schema":{"type":"string"},"example":"Puhekupla"},{"name":"hotel","in":"query","required":false,"description":"Hotel code (default com)","schema":{"type":"string"},"example":"com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"hhus-fcfff510c4c2cc81790d725126111dbe","name":"Puhekupla","level":9,"motto":":)","rooms":[{"id":30158447,"name":"asdf","tags":[],"rating":14,"max_visitors":25},{"id":74935991,"name":"[]jbhn","tags":[],"rating":1,"description":"","max_visitors":10}],"avatar":{"full":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=l&direction=2&head_direction=2&action=std","small":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=s&direction=2&head_direction=2","headshot":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=l&headonly=1&direction=2&head_direction=3"},"figure":"hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66","groups":[],"online":false,"source":"Habbo","star_gems":0,"room_count":2,"badge_count":36,"group_count":0,"last_online":"2017-11-08T23:22:09.000+0000","friend_count":0,"member_since":"2009-08-21T23:22:47.000+0000","level_percent":4,"profile_visible":true,"total_experience":141},"meta":{"timestamp":"2026-06-09T11:38:27.693Z","request_id":"16d5b33c-40b7-427c-8594-233ac32f17c1"},"status":"ok","message":"Profile retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user":{"get":{"operationId":"get_v1_user","tags":["Habbo"],"summary":"A player's public profile","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Player name","schema":{"type":"string"},"example":"Puhekupla"},{"name":"hotel","in":"query","required":false,"description":"Hotel: com, br, de, es, fi, fr, it, nl, tr (default com)","schema":{"type":"string"},"example":"com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"hhus-fcfff510c4c2cc81790d725126111dbe","name":"Puhekupla","level":9,"motto":":)","avatar":{"full":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=l&direction=2&head_direction=2&action=std","small":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=s&direction=2&head_direction=2","headshot":"https://www.habbo.com/habbo-imaging/avatarimage?figure=hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66&size=l&headonly=1&direction=2&head_direction=3"},"figure":"hr-125-31.hd-180-1.ch-210-1320.lg-275-90.sh-908-68.ha-1003-66","online":false,"source":"Habbo","star_gems":0,"last_online":"2017-11-08T23:22:09.000+0000","member_since":"2009-08-21T23:22:47.000+0000","level_percent":4,"profile_visible":true,"selected_badges":[{"code":"UK190","name":"Puhekupla Event winner","description":"Champion chocolate snatcher"},{"code":"COW01","name":"Cowboyween","description":"Trick or Treat?"}],"total_experience":141},"meta":{"timestamp":"2026-06-09T11:38:27.923Z","request_id":"94126a02-cbda-496d-811f-58c3c6b0c722"},"status":"ok","message":"User retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hotels":["com","us","br","de","es","fi","fr","it","nl","tr"],"source":"Habbo public API (live)","service":"habbo-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/user":"A player's public profile (name=Puhekupla, hotel=com): motto, level, online, showcase badges.","GET /v1/avatar":"Avatar image URLs at several sizes from a player's figure (name=, hotel=).","GET /v1/badges":"Every badge a player has earned (name=, hotel=): code, name, description.","GET /v1/profile":"A player's public social graph (name=, hotel=): groups, rooms, friend & badge counts."},"description":"Live player profiles from Habbo Hotel, the long-running virtual-world social platform, from Habbo's official public API: a player's public profile (avatar figure, motto, online status, member-since and last-online, level, experience, showcase badges); their public social graph (groups, player-built rooms, friend and badge counts); every badge they have earned with code, name and description; and ready-to-use avatar image URLs at several sizes built from their figure string. Every hotel supported (com, br, de, es, fi, fr, it, nl, tr). Live, no key, nothing stored. Distinct from mainstream social-network APIs — this is the Habbo virtual world: avatars, badges, groups and rooms.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T11:38:28.154Z","request_id":"550003f0-38d7-4656-bbae-e25599a8027d"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2100,"monthly_call_quota":220000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4900,"monthly_call_quota":1200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/habbo-api"}