Map supplier rooms to reference rooms (many-to-many)

Maps each supplier room to the best reference room using a multilingual cross-encoder. The service scores the full supplier×reference grid (M×N pairs), applies Platt calibration, and returns per-supplier ranked candidates plus an optional selected match when the top candidate clears the decision threshold.

Use when you have a canonical reference catalog and need per-supplier mapping decisions with confidence scores.

Key Parameters

  • hotelId: Correlation id; echoed in the response
  • chunkKey: Batch/chunk id for large property processing
  • threshold: Minimum calibrated score for a positive match (predictedLabel == 1). Default: 0.5
  • topK: Number of ranked candidates returned per supplier. Default: 3
  • lowercase: Lowercase room text before scoring. Default: true
  • includeLogitRaw: Include raw model logits on each candidate when true. Default: false
  • references: Canonical reference rooms (array with id and name)
  • suppliers: Supplier rooms to map (array with index i and name)

Per-supplier Result

status is mapped when the rank-1 candidate has predictedLabel == 1 and scoreCalibrated >= threshold; otherwise not_mapped with selected: null and candidates still populated.

To experiment with this API, use the sandbox key:
e2R4t6Y8u0i3O5p7A9s1D3f5G7h9J2k4

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string | null

Correlation id; echoed in the response.

string | null

Batch/chunk id for large property processing.

float
0 to 1
Defaults to 0.5

Minimum calibrated score for a positive match (predictedLabel == 1).

integer
≥ 1
Defaults to 3

Number of ranked candidates returned per supplier.

float | null
0 to 1

Reserved for future margin gating (currently informational).

integer
≥ 1
Defaults to 64

Informational batch hint on the request.

boolean
Defaults to true

Lowercase room text before scoring.

boolean
Defaults to false

Include raw model logits on each candidate when true.

references
array of objects
required
length ≥ 1

Canonical reference rooms.

references*
required

Reference room id.

string
required

Reference room title.

suppliers
array of objects
required
length ≥ 1

Supplier rooms to map.

suppliers*
integer
required

Supplier row index (stable within the request).

string
required

Supplier room title.

Responses

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