H2B API – Search: Search

Această metodă permite căutarea ofertelor de cazare disponibile, în funcție de diverși parametri (oraș, țară, date de check-in/out, număr de persoane, camere disponibile, politici etc.). Este utilă în implementarea unui motor de căutare pentru utilizatori finali sau pentru procesarea automată a ofertelor.
Se recomandă utilizarea acestei metode în timp real, la inițierea unei căutări de către utilizator, fără rulare prin cronjob.

Endpoint:
POST /api/?type=search&call=search-search

Parametri explicați:
auth_key
Tip: string
Obligatoriu: Da
Cheia de autentificare pentru acces la API-ul H2B.

City_Id
Tip: integer
Obligatoriu: Da
ID-ul orașului în care se caută unități (obținut din metoda Geography – Cities).

Country_Id
Tip: integer
Obligatoriu: Da
ID-ul țării (din metoda Geography – Countries).

Check_In
Tip: string (format: YYYY-MM-DD)
Obligatoriu: Da
Data de check-in pentru cazare.

Check_Out
Tip: string (format: YYYY-MM-DD)
Obligatoriu: Da
Data de check-out pentru cazare.

With_Available_Rooms
Tip: integer (0/1)
Obligatoriu: Nu
Setează 1 pentru a returna doar camerele disponibile (max. 9 rezultate / cameră).

Adults
Tip: integer
Obligatoriu: Da
Numărul de adulți pentru care se face căutarea.

Children_Ages
Tip: string (ex: „4,7”)
Obligatoriu: Nu
Vârstele copiilor, separate prin virgulă, dacă este cazul.

Property_Id
Tip: integer
Obligatoriu: Nu
ID-ul unei unități specifice, dacă se dorește filtrarea.

Access_All_Properties
Tip: integer (0/1)
Obligatoriu: Nu
Dacă este activat pentru utilizator, poate accesa toate unitățile.

Group_By_Min_Price
Tip: integer (0/1)
Obligatoriu: Nu
Activează gruparea pe cel mai mic tarif.

Debug_Mode
Tip: integer (0/1)
Obligatoriu: Nu
Activează modul debug, returnând și înregistrările invalide cu motivul corespunzător.

Request:

POST /api/?type=search&call=search-search
Content-Type: application/x-www-form-urlencoded

auth_key=API_KEY&
City_Id=408&
Country_Id=1&
Check_In=2030-08-01&
Check_Out=2030-08-02&
With_Available_Rooms=0&
Adults=2&
Children_Ages=&
Property_Id=319&
Access_All_Properties=0&
Group_By_Min_Price=&
Debug_Mode=0

Response:

Răspunsul conține două elemente relevante:
headings: lista capetelor de coloană pentru fiecare câmp (în ordinea exactă a valorilor din results)
results: o listă de rezultate, fiecare reprezentând o ofertă (camere, preț, politici etc.), în format array.

				
					"headings": [
  "date",
  "nights",
  "price",
  "property",
  "room",
  "count",
  "rate",
  "facil",
  "with_extra_bed",
  "currency",
  "meal",
  "extra_services",
  "payment_policy",
  "cancelation_policy",
  "comission",
  "price_change_fixed",
  "price_change_percent",
  "available_rooms",
  "missing_contract",
  "price_without_commission"
],
"results": [
  [
    "2030-08-01",     // date
    1,                // nights
    625,              // price
    319,              // property ID
    957,              // room ID
    1,                // count
    536,              // rate plan ID
    0,                // facil (not detailed here)
    0,                // with_extra_bed
    "EUR",            // currency
    [4995, "breakfast"], // meal (ID + tip)
    [[14573, 1]],        // extra_services (ID + qty)
    1,                // payment_policy ID
    1,                // cancelation_policy ID
    20,               // comision %
    0,                // price_change_fixed
    0,                // price_change_percent
    null,             // available_rooms (null = necunoscut)
    0,                // missing_contract
    500               // price_without_commission
  ]
]