Group rooms without a reference catalog

Overview

Group similar room listings for a property without needing a reference catalog. Automatically clusters rooms based on attributes like room class, bed type, and view.

When to Use

  • No reference catalog - Cluster rooms when you don't have a canonical room list
  • Multi-supplier aggregation - Group equivalent rooms across different suppliers
  • Deduplication - Identify duplicate or near-duplicate room listings
  • Content analysis - Extract structured attributes from room names

What You Get

  • Room groups - Clusters with groupCode, groupName, and member rooms
  • Unmapped rooms - Rooms that couldn't be grouped
  • Display names - Suggested names for each group
  • Parsed attributes - Extracted room details (when debug: true)

Quick Start

Required fields: propertyId, propertyName, supplierList with rooms

Customize grouping: Set parameters.outputAggregation to control which attributes form groups (default: roomClass, roomType, bedType, roomView)

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
boolean
Defaults to false

When true, returns parsed entities per room

string
required

Display name of the hotel

string
required

Stable property identifier in your catalog

parameters
object

Grouping behaviour controls

supplierList
array of objects
required
length ≥ 1

One object per supplier channel

supplierList*
string
required

Supplier display name

string
required

Supplier identifier in your system

supplierRooms
array of objects
required
length ≥ 1

Rooms from that supplier for this property

supplierRooms*
string
required

Supplier room or rate identifier

string
required

Raw room title from the supplier feed

string

Optional bed-type hint

string

Optional room-type hint

string

Optional class hint

string

Optional view hint

Responses

401

Unauthorized

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json