Habbo API Documentation

API Reference

Documentation for the Habbo Market History and Furniture Image APIs.

Made by QDave

Market History API

Retrieve furniture items of market history data with up to 2 years of sales and metadata

Base URL: https://habboapi.site
GET /api/market/history

Search for furniture items and retrieve their market history, including price trends, volume data, and metadata.

Query Parameters

classname string required*

Search by furniture classname. Supports wildcards: * for multiple characters, _ for single character.

name string required*

Search by furniture name (partial match, case-insensitive).

description string required*

Search by furniture description (partial match, case-insensitive).

hotel string optional

Hotel domain code. Valid values: com, de, es, fi, fr, it, nl, br, tr. Default: com

days number optional

Limit history to specified number of days. Use all for complete history. Default: all

Note

At least one of classname, name, or description is required.

Example Requests
/api/market/history?classname=throne&hotel=com
/api/market/history?classname=hc_*&hotel=com&days=30
/api/market/history?name=Dragon&hotel=com
/api/market/history?description=rare&hotel=com&days=7

Response Format

[
  {
    "ClassName": "throne",
    "FurniName": "Throne",
    "FurniDescription": "Important Habbos only",
    "Line": "rare",
    "Category": "chair",
    "Revision": 45512,
    "FurniType": "roomItem",
    "marketData": {
      "history": [
        [avgPrice, soldItems, creditSum, openOffers, timestamp],
        ...
      ],
      "averagePrice": 1338,
      "lastUpdated": "2025-05-26 at 15:02"
    },
    "hotel_domain": "com"
  }
]
History Array Format

Each history entry contains: [avgPrice, soldItems, creditSum, openOffers, timestamp]

Rate Limiting

Default: 30 requests per minute. For unlimited access, include header: X-Auth-Key: your-api-key

Furniture Image API

Retrieve furniture images with customizable parameters

Base URL: https://habboapi.site
GET /api/image/:classname

Get a PNG image of the specified furniture item. Images are generated on-demand and cached for fast retrieval.

Path Parameters

classname string required

Furniture classname. For colored items, include the color: rare_dragonlamp*4

Example Requests
/api/image/throne
/api/image/throne.png
/api/image/rare_dragonlamp*4
/api/image/club_sofa
Response

Returns a PNG image with Content-Type: image/png

Image Generation

If an image hasn't been generated yet, the API will return a 202 status with a message to retry. Images are queued for generation automatically.