preiskalender.imZeitraum
Price calendar for the period from to to (YYYY-MM-DD; from must not be after to): per day, occupancy, the set price per room type, the stored price suggestion with the gap to it, neighboring prices, own crawled competitor price and market position (unter, im, über). Also, for the "Markt" view: occupied rooms, the set double-room price and the current price at Booking level, the median of the budget group with a hint per night, and the price of every other hotel (`haeuser`, `preiseJeHaus`). Owner only. Read-only, does not set prices.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
von | string | yes | |
bis | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
zimmertypen | array of string | yes | |
tage | array of object | yes | |
tage.datum | string | yes | |
tage.auslastungProzent | number · nullable | yes | |
tage.markt | object · nullable | yes | |
tage.sammlerpreisCents | integer · nullable | yes | |
tage.marktAbweichungProzent | integer · nullable | yes | |
tage.marktLage | enum · nullable | yes | One of: unter, im, ueber |
tage.nachZimmertyp | array of object | yes | |
tage.belegteZimmer | integer | yes | |
tage.doppelzimmerCents | integer · nullable | yes | |
tage.vergleichspreisCents | integer · nullable | yes | |
tage.budgetMedianCents | integer · nullable | yes | |
tage.budgetHaeuserAnzahl | integer | yes | |
tage.budgetAbweichungProzent | integer · nullable | yes | |
tage.hinweis | enum | yes | One of: kein_preis, duenn, unter_allen, ueber_budget, unter_budget, im_rahmen, ohne_budget |
tage.preiseJeHaus | array of object | yes | |
hatNachbarpreise | boolean | yes | |
hatVorschlaege | boolean | yes | |
hatEigenePreise | boolean | yes | |
zimmerAnzahl | integer | yes | |
haeuser | array of object | yes | |
haeuser.hotelUrl | string | yes | |
haeuser.hotelName | string | yes | |
haeuser.budget | boolean | yes | |
typischerAbstandCents | integer · nullable | yes | |
erhobenAm | string · nullable | yes |
preiskalender.jahresband
Twelve month tiles starting from the current month: the map above the month view. No input: the window is always "current month + 11", there is nothing to configure (see JAHRESBAND_MONATE, justified against the measured 388-day horizon of the crawled competitor prices). Read-only query.
Input parameters
Returns object.
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
monate | array of object | yes | |
monate.monat | string | yes | |
monate.tageGesamt | integer | yes | |
monate.tageOffen | integer | yes | |
monate.tageOhneEigenenPreis | integer | yes | |
monate.tageMitMarkt | integer | yes | |
monate.starkeTage | integer | yes | |
monate.tageMitVorschlag | integer | yes | |
fensterMedianCents | integer · nullable | yes | |
starkAbCents | integer · nullable | yes |