← Back to Dashboard

Helper / Glossary

What does this tool do?

This tool monitors the smyrooms.com search API for price consistency. It automatically makes repeated identical requests to detect if the API returns different prices for the same query.

Monitoring Flow

1. Pick random dates (3-6 months ahead) and stay duration (3, 5 or 7 nights)
2. SEARCH #1 → POST to /search with hotel (from Settings), 2 adults
   wait 25 seconds
3. SEARCH #2 → identical request
   wait 25 seconds
4. SEARCH #3 → identical request
   then for each option returned:
5. QUOTE → POST to /valuation with the AgencyToken of each option (10 threads)
6. SEARCH #4 → identical request (post-quote verification)
7. Compare all prices → flag differences
   wait 5 minutes → repeat

What is compared?

Search Consistency

The 4 search requests use the exact same payload. The prices from all 4 responses are compared by option key. Search #4 runs after the quote phase to detect if prices changed post-quote. If any price differs between the 4 calls, the group is flagged as SEARCH.

Quote Consistency

After searches #1-#3, each option from the last search response is sent to the valuation endpoint to get a confirmed quote price. If the quote price differs from the search price, or the API returns an error, the group is flagged as QUOTE. Search #4 then verifies if prices remain available after the quote.

Option Key

Each option is identified by a composite key:

ComponentExampleDescription
Hotel Code(from Settings)Hotel identifier
Meal PlanHD / SAHalf Board / Room Only
Room NameHabitaciónRoom type description
Room Code6297Room type code
PackageTrue/FalseRateRule type 4 = package rate
NRFTrue/FalseNon-refundable flag

Format: hotel|mealplan|room_name|room_code|package|nrf

Status Badges

OKAll prices consistent across searches and quotes
SEARCHPrice difference detected between the 4 search requests
QUOTEQuote price differs from search price, or API returned an error for quote

API Endpoints

StepURLMethod
Searchhttps://api.smyrooms.com/searchPOST
Quote (Valuation)https://api.smyrooms.com/valuationPOST

Parameters

ParameterSearchQuote
Hotel(from Settings)from AgencyToken
CurrencyEUREUR
MarketNL-
Nationality-NL
Occupancy2 adults (age 30)from AgencyToken
DatesRandom, 3-6 months aheadfrom AgencyToken

Data Storage

Multi-Hotel Comparison

What is Multi-Hotel Comparison?

This feature detects price inconsistencies when searching for multiple hotels at once vs searching for each hotel individually. The API may return different prices or options depending on how many hotels are in the request.

Multi-Hotel Flow

1. Pick random dates (3-6 months ahead) and stay duration (3, 5 or 7 nights)
2. MULTI SEARCH → POST to /search with ~90 hotels in one request
3. For each hotel that returned results:
   SINGLE SEARCH → POST to /search with just that 1 hotel (10 parallel threads)
4. Compare prices: Multi vs Single for each hotel
5. Flag differences where options disappeared or prices went up

What is compared?

For each hotel, we compare all options returned in the multi-search vs the single-search. Options are matched by key (meal plan + room + package + NRF). We flag two types of problems:

We do NOT flag: options that only exist in single-search (extra availability is OK), or prices that went down (cheaper is OK).

Multi Option Key

For multi-hotel comparison, the key does NOT include the hotel code (since we already know which hotel):

ComponentExampleDescription
Meal PlanHD / SAHalf Board / Room Only
Room NameHabitación DobleRoom type description
Room CodeM18829Room type code
PackageTrue/FalseRateRule type 4 = package rate
NRFTrue/FalseNon-refundable flag
CurrencyEUR / USDPrice currency

Format: mealplan|room_name|room_code|package|nrf|currency

Important: Package rates are compared with package rates, non-package with non-package. Same for NRF. EUR prices are compared with EUR, USD with USD.

Multi Status Badges

OKOption exists in both with same price
MISSINGOption exists in multi but NOT in single (disappeared)
PRICE DIFFOption exists in both but prices differ
ONLY SINGLEOption only exists in single-search (not flagged as problem)

Drill-Down View

Click on any hotel code in the results table to see a detailed breakdown:

Why does this happen?

Possible causes for multi vs single inconsistencies: