pyhabbo

Unofficial Python SDK for the Habbo public Web API.

Not affiliated with or endorsed by Sulake Oy or Habbo.

Install

pip install pyhabbo

Requires Python 3.11+.

Install from source

git clone https://github.com/0xChron/pyhabbo
cd pyhabbo
pip install -r requirements.txt
pip install .

Quick start

from pyhabbo import HabboClient, Hotel

client = HabboClient(hotel=Hotel.COM)
client.ping()

user = client.users.get_by_name("Habbo")
print(user.name, user.current_level)

profile = client.users.get_profile(user.unique_id)
print(len(profile.badges), len(profile.friends))

Hotels

Pass a Hotel to target a specific Habbo hotel:

client = HabboClient(hotel=Hotel.DE)   # habbo.de
client = HabboClient(hotel=Hotel.FI)   # habbo.fi
client = HabboClient(hotel=Hotel.COM)  # habbo.com (default)

Available hotels: COM, DE, ES, FI, FR, IT, NL, BR, TR.

You can also pass a custom base_url if needed.

API

Users

Method	Endpoint
client.users.get_by_name(name)	GET /users?name=
client.users.get(user_id)	GET /users/{id}
client.users.get_profile(user_id)	GET /users/{id}/profile
client.users.list_friends(user_id)	GET /users/{id}/friends
client.users.list_groups(user_id)	GET /users/{id}/groups
client.users.list_rooms(user_id)	GET /users/{id}/rooms
client.users.list_badges(user_id)	GET /users/{id}/badges

Achievements

Method	Endpoint
client.achievements.list_all()	GET /achievements
client.achievements.list_for_user(user_id)	GET /achievements/{user_id}

Groups

Method	Endpoint
client.groups.get(group_id)	GET /groups/{id}
client.groups.list_members(group_id)	GET /groups/{id}/members

Badges

Method	Endpoint
client.badges.get_owners(badge_code)	GET /badge/owners/{badgeCode}

Rooms

Method	Endpoint
client.rooms.get(room_id)	GET /rooms/{roomId}

Lists

Method	Endpoint
client.lists.list_hotlooks()	GET /lists/hotlooks

Marketplace

Method	Endpoint
client.marketplace.batch_stats(room_items=[], wall_items=[])	POST /marketplace/stats/batch

Examples

Runnable scripts for each endpoint are in examples/.

git clone https://github.com/0xChron/pyhabbo
cd pyhabbo
pip install .
python examples/public/users/get_by_name.py

Official API docs

Habbo Web API Swagger UI

Development

For contributors — clone the repo and install dev dependencies:

git clone https://github.com/0xChron/pyhabbo
cd pyhabbo
pip install -e ".[dev]"
pytest
ruff check src tests

CI runs on push/PR to main (pytest + ruff on Python 3.11–3.13).

Versioning: bump src/pyhabbo/_version.py only — hatch reads it for PyPI builds.

License

MIT — see LICENSE.

Changelog

See CHANGELOG.md.