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.
`per_page`	Integer (Default: 50/200)	No	Paginates the result by value provided.

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

Warning: file_get_contents(https://api.habboapi.net/habbos?per_page=50): failed to open stream: Connection timed out in /customers/1/a/a/habboapi.net/httpd.www/docs/habbos/request.php on line 405 Warning: Invalid argument supplied for foreach() in /customers/1/a/a/habboapi.net/httpd.www/docs/habbos/request.php on line 406

HabboAPI Documentation

URL Parameters

Response Fields