HabboAPI Documentation

Join us on Twitter
Menu
Star

Request Furniture

If you want to make a list of the latest furniture added to Habbo, or a tool that displays furniture by line, you will need to make a Furniture Request. 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 all furniture added after 28-04-2017, will not have descriptions. Habbo has stopped useing Badge and Furni descriptions, on all hotels.


We have devided the different furniture up, so you are able to make lists of furniture for each line.

URL Parameters


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


Name Type Required Details
id

String

No

Wildcard search for furniture with that id, provided by us.
name

String

No

Wildcard search for furniture with that name.
description

String

No

Wildcard search for furniture with that description.
code

String

No

Wildcard search for furniture with that code.
habbo_furni_id

String

No

Wildcard search for furniture with a specific furniture id.
furni_line

String

No

Wildcard search for furniture within a specific furniture line.
new

String

No

If supplied, will only return new furniture.
for_sale

String

No

If supplied, will only return furniture for sale.
builders_club

String

No

If supplied, will only return furniture in builders club.
per_page

Integer
(Default: 50/200)

No

Paginates the result by value provided.

Response Fields


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


Name Type Details
id

String

Return furniture id, provided by us.
name

String

Return furniture name.
description

String

Return furniture description.
code

String

Return unik furniture code.
habbo_furni_id

String

Return specific furniture id.
furni_line

String

Return specific furniture line.
furni_line_name

String

Return custom furniture line name.
image

String

Return full URL to furniture image.
icon

String

Return full URL to furniture icon.
public_icon

String

Return full URL to furniture icon, hosted on Habbos server.
colors

Array

Return color_id's and the HEX color code.
directions

Array

Return direction_id's and image of the direction.
states

Array

Return state_id's and image of that state.
new

Boolean

Return true or false, if the furniture is less then 24 hours old.
for_sale

Boolean

Return true or false, if the furniture is for sale.
builders_club

Boolean

Return true or false, if the furniture is in Builders Club.
discovered_at

String

Return date and time on the day we discovered it.
discovered_at_iso

String

Return iso timestamp on the day we discovered it.
total

String

Return total amount of furniture.
per_page

String

Return furniture shown per page.
prev_page_url

String

Return full url to previous furniture page.
next_page_url

String

Return full url to next furniture page.

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


Next: Furniture Directions


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 furniture
$(function(){

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

// Get furniture from our API
$furnis = json_decode(file_get_contents($api_url), true); 
foreach($furnis['data'] as $furni){
	// Echo out furniture
	echo '<img src="' . $furni['icon'] . '" />'; 
}
Json API response example
{
	"current_page":1,
	"data":[
		{
			"id":6939,
			"name":"xmas_c19_box1 name",
			"code":"xmas_c19_box1",
			"description":"xmas_c19_box1 desc",
			"habbo_furni_id":10943,
			"furni_line":"xmas2019",
			"furni_line_name":"xmas2019",
			"image":"https://api.habboapi.net/furni/xmas_c19_box1/image",
			"icon":"https://api.habboapi.net/furni/xmas_c19_box1/icon",
			"public_icon":"http://habboo-a.akamaihd.net/.../65312/xmas_c19_box1_icon.png",
			"colors":[ ],
			"directions":[
				{
					"direction_id":0,
					"image":"https://api.habboapi.net/furni/xmas_c19_box1/image?direction=0",
				},
				{
					"direction_id":2,
					"image":"https://api.habboapi.net/furni/xmas_c19_box1/image?direction=2",
				},
			],
			"states":[
				{
					"state_id":2,
					"image":"https://api.habboapi.net/furni/xmas_c19_box1/image?state=2",
				}
			],
			"for_sale":false,
			"builders_club":false,
			"discovered_at":"2019-10-21 13:41:33",
			"discovered_at_iso":"2019-10-21T13:41:33+00:00",
			"new":false,
		}
	],
	"from":1,
	"last_page":6446,
	"next_page_url":"https://api.habboapi.net/furni?page=2",
	"path":"https://api.habboapi.net/furni",
	"per_page":"50",
	"prev_page_url":null,
	"to":1,
	"total":6446,
}
HTML Result Example
Warning: file_get_contents(https://api.habboapi.net/furni?per_page=50): failed to open stream: Connection timed out in /customers/1/a/a/habboapi.net/httpd.www/docs/furniture/request.php on line 489 Warning: Invalid argument supplied for foreach() in /customers/1/a/a/habboapi.net/httpd.www/docs/furniture/request.php on line 490