HabboAPI Documentation

Request Habbos

If you want to make a tool, where you can search up Habbos and get their information for your Fansite, this is the endpoint to use. This endpoint will allow you to search up Habbos, find their friends, badges and other cool info on them. The following documentation shows you have to do that, wich URL Parameters you can use and wich Response Fields you will get back.


Note that we started collecting Habbos, 08-05-2020. Because of the way Habbo has made it, we dont have all Habbos. We will slowly build up our archive of Habbos.


You can find Habbos from all 9 Habbo hotels. Just search them up and find their information.

URL Parameters


The following table shows request parameters you can use in a Habbos API call.


Name Type Required Details
name

String

No

Wildcard search for Habbos with that name.

habbo_id

String

No

Wildcard search for Habbos with that ID.

hotel

String

No

Wildcard search for Habbos from a specific hotel.

Response Fields


The following table shows response fields returned by the Habbos API call.


Name Type Details
name

String

Return Habbo name.

profile

String

Return Habbo profile link.

motto

String

Return Habbo Motto.

habbo_id

String

Return unik Habbo ID.

hotel

String

Return hotel.

member_since

ISO String

Return a date for user creation.

figure_string

String

Return figure string.

figure_large

String

Return url to large Avatar.

figure_medium

String

Return url to medium Avatar.

figure_small

String

Return url to small Avatar.

badges

Array

Return array of badges.

friends

Array

Return array of friends.

total

String

Return total amount of Habbos.

per_page

String

Return Habbos shown per page.

prev_page_url

String

Return full url to previous Habbos page.

next_page_url

String

Return full url to next Habbos page.


We hope to bring much more features to the API, in the future.




Get a simple list of Furniture

  • jQuery
  • PHP
// Make sure you include the official jQuery Library
// This is a simple example and return a list of 50 Habbos
$(function(){

	// Get Habbos from our API
	$.getJSON('https://api.habboapi.net/habbos?per_page=50', function(habbos){
		$.each(habbos.data, function(key, habbo){
			// Append Habbos to div
			$('#habbos').append('<img src="' + habbo.figure_small + '" />');	
		});
	});
})
// JavaScript
// This is a simple example and will only give you a list of Habbos
$api_url = 'https://api.habboapi.net/habbos?per_page=50';

// Get Habbos from our API
$furnis = json_decode(file_get_contents($api_url), true); 
foreach($habbos['data'] as $habbo){
	// Echo out habbos
	echo '<img src="' . $habbo['figure_small'] . '" />'; 
}
Json API response example
{
	{
		"name":DJ-rapand,
		"profile":"https://api.habboapi.net/habbos/DJ-rapand",
		"motto":"Youtube: Rapand",
		"habbo_id":"hhus-0dabef8a4f2d2753abb44cd4e086d13f",
		"hotel":"com",
		"member_since":{
			"date":"2005-01-31 13:50:24.000000",
			"timezone_type":1,
			"timezone":"+00:00"
		},
		"figure_string":"hr-828-61.hd-3092-3.ch-3015-1335.lg-3116-91-92.he-3155-92.fa-1203.ca-3217-63-1408",
		"figure_large":"https://www.habbo.com/habbo-imaging/avatarimage?size=l&figure=hr-828-61.hd-3092-3.ch-3015-1335.lg-3116-91-92.he-3155-92.fa-1203.ca-3217-63-1408",
		"figure_medium":"https://www.habbo.com/habbo-imaging/avatarimage?size=m&figure=hr-828-61.hd-3092-3.ch-3015-1335.lg-3116-91-92.he-3155-92.fa-1203.ca-3217-63-1408",
		"figure_small":"https://www.habbo.com/habbo-imaging/avatarimage?size=s&figure=hr-828-61.hd-3092-3.ch-3015-1335.lg-3116-91-92.he-3155-92.fa-1203.ca-3217-63-1408",
		"badges":[
			{
				"code":"15H06",
				"name":"Happy 15th Birthday, Habbo!",
				"description":"For participating in the Community Challenge",
				"hotel":"com",
				"discovered_at_iso":"2017-09-10T10:01:32+00:00",
				"discovered_at":"2017-09-10 10:01:32",
				"image":"https://habboo-a.akamaihd.net/c_images/album1584/15H06.gif",
				"achievement":false,
				"has_image":true
			},
		],
		"friends":[
			{
				"name":"inctor",
				"motto":"HabboAPI",
				"habbo_id":"hhus-a82850d0a9c23431936fe828e26cbe3d",
				"member_since":"2017-12-30 09:57:39",
				"figure_string":"hr-155-38.hd-209-1.ch-255-64.lg-270-1408.sh-906-80",
				"figure":"https://www.habbo.com/habbo-imaging/avatarimage?size=l&figure=hr-155-38.hd-209-1.ch-255-64.lg-270-1408.sh-906-80"
			},
		]
	}
}
HTML Result Example
antonio8994BOSS96BELLOscreenZLucaaaaaaaaaahlinobareseJocelula@Ale71@PragmatiqYes_Im_Gingerxdsallybbyzioop123xxxramiexxxX-Gansterz-XXxCutieFiffyxXYoungThug12345xxxxilovemusicxtreytheboss1uio211swaggers23tinkerbellyusama9000vince_123xNayemxxNinjaturtle.xjelly516TheCJZ2001trey56497trisha679TimothyHoraciotyler0453trey1588UnListed.victoriousgirl.talloliviafanTheOfficialRinTrentHasSwaggthom65TrapStarKittysoirtngiSwaggboi74sophwashereswaggkid28spyjesseStartaylor3044tadacatsu123TheNeverSlushieMesaigegirlhySkilika.BadazzSkySoldierMC