جست‌وجوی هتل

curl -X POST https://api.simorghapi.com/v3/HAPI/hotels/searches \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "check_in": "2026-11-14",
    "check_out": "2026-11-16",
    "city_id": 1019782831,
    "occupancies": [ { "adults": 2 } ],
    "sort": "review_score",
    "filters": {
      "stars": [4, 5],
      "facility": [107, 433],
      "meals": ["breakfast"],
      "free_cancellation": [true]
    }
  }'

"facets": [
  { "key": "stars", "title": "Property rating", "type": "range",
    "options": [ { "value": 5, "name": "5 stars", "count": 639 }, { "value": 4, "name": "4 stars", "count": 4196 } ] },
  { "key": "facility", "title": "Facilities", "type": "enum",
    "options": [ { "value": 107, "name": "Free WiFi", "count": 6110 }, { "value": 433, "name": "Swimming pool", "count": 5604 } ] },
  { "key": "meals", "title": "Meals", "type": "enum",
    "options": [ { "value": "breakfast", "name": "Breakfast included", "count": 652 } ] },
  { "key": "free_cancellation", "title": "Free cancellation", "type": "boolean",
    "options": [ { "value": true, "name": "Free cancellation", "count": 4614 } ] }
],
"sorts": [ { "id": "price", "name": "Price (low to high)" }, { "id": "review_score", "name": "Guest review score" } ]

curl -X POST https://api.simorghapi.com/v3/HAPI/hotels/searches \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "check_in": "2026-11-14",
    "check_out": "2026-11-16",
    "city_id": 1019782831,
    "occupancies": [ { "adults": 2 } ]
  }'

{
  "object": "hotel_search",
  "id": "hsr_485158995",
  "mode": "city",
  "check_in": "2026-11-14",
  "check_out": "2026-11-16",
  "nights": 2,
  "total": 6263,
  "sort": null,
  "filters_applied": {},
  "sorts": [ { "id": "price", "name": "Price (low to high)" }, { "id": "stars_desc", "name": "Stars (5 to 0)" } ],
  "facets": [
    { "key": "stars", "title": "Property rating", "type": "range", "options": [ { "value": 5, "name": "5 stars", "count": 639 } ] },
    { "key": "facility", "title": "Facilities", "type": "enum", "options": [ { "value": 107, "name": "Free WiFi", "count": 6110 } ] }
  ],
  "pagination": { "page": 1, "page_size": 140, "total_pages": 8, "has_next": true, "has_prev": false },
  "offer_count": 140,
  "offers": [
    {
      "object": "hotel_summary",
      "hotel_id": "70784396381",
      "name": "Vida Creek Harbour",
      "lead_rate": { "amount": "165.52", "currency": "USD" },
      "lead_rate_before_discount": null,
      "discount_percent": 0,
      "deal_badges": [],
      "meal_plan": "Room Only",
      "refundable": true,
      "free_cancellation": true,
      "nights": 2,
      "occupancy": { "adults": 2, "children": 0 },
      "rating": 5,
      "review_score": 8.6,
      "review_count": 1565,
      "review_word": "Very good",
      "accommodation": "Hotels",
      "address": { "city": "Dubai", "country": "United Arab Emirates", "country_code": "AE" },
      "location": { "lat": 25.19, "lng": 55.35 },
      "images": [ "…" ]
    }
  ]
}

{
  "object": "hotel_search",
  "id": "hsr_738363500",
  "mode": "hotel",
  "check_in": "2026-11-14",
  "check_out": "2026-11-16",
  "nights": 2,
  "hotel": {
    "id": "70784396381",
    "name": "Vida Creek Harbour",
    "rating": 5,
    "address": { "line": "…", "city": "Dubai", "country": "United Arab Emirates", "country_code": "AE", "postal_code": "…" },
    "location": { "lat": 25.19, "lng": 55.35 },
    "images": [ "…" ],
    "description": "…",
    "check_in_from": "15:00",
    "check_out_until": "12:00",
    "facility_groups": [ { "name": "General", "facilities": [ "Air conditioning", "…" ] } ]
  },
  "offer_count": 39,
  "offers": [
    {
      "object": "hotel_rate",
      "id": "hrt_TkRNNU5qTTRNWHd5…",
      "total": { "amount": "165.52", "currency": "USD" },
      "total_before_discount": null,
      "discount_percent": 0,
      "deal_badges": [],
      "refundable": true,
      "refundable_until": "2026-11-12T23:59:00",
      "available_rooms": 5,
      "units": 1,
      "board": "Breakfast included",
      "board_basis": "breakfast_included",
      "board_included": [ "Breakfast included (Buffet)" ],
      "rooms": [
        {
          "id": "…",
          "name": "Classic Twin Room with City View",
          "adults": 2,
          "children": 0,
          "beds": [ "2 single beds" ],
          "max_occupancy": 2,
          "size_m2": 32,
          "description": "…",
          "images": [ "…" ]
        }
      ],
      "payment": { "title": "Pay online", "description": "…", "deposit_required": true },
      "cancellation": { "non_refundable": false, "type": "free_cancellation", "policy_text": "…" }
    }
  ]
}