Skip to content
Docs

ZenHotels

Room rates with the taxes paid at the hotel spelled out.Every room and rate at one ZenHotels hotel for a stay. Each rate's total includes the taxes the rate shows; taxes paid at the hotel, such as a resort fee or city tax, are listed apart. Meal, refundability and pay-at-hotel come with each rate.
Look up by
Hotel URL, slug or name
Coverage
Worldwide
Cost
12 credits a call; failed and empty calls are free
Endpoints
1 endpoint
  • Prices
  • Rooms and rate plans

Endpoints

Example

ZenHotels rooms, with POST /v1/ota/zenhotels. Set SCRAPERCOMPANY_API_KEY to your key and run it; the full parameter list is in the API reference.

curl -X POST "https://api.scrapercompany.com/v1/ota/zenhotels" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "check_in": "2026-12-25"
  }'
200 response
{
  "search_parameters": {
    "engine": "zenhotels_property",
    "hotel": "the_savoy_a_fairmont_managed_hotel",
    "check_in_date": "2027-03-08",
    "check_out_date": "2027-03-10",
    "nights": 2,
    "adults": 2,
    "rooms": 1,
    "currency": "USD"
  },
  "property": {
    "property_id": "the_savoy_a_fairmont_managed_hotel",
    "master_id": 7801627,
    "name": "The Savoy",
    "url": "https://www.zenhotels.com/hotel/united_kingdom/london/mid7801627/the_savoy_a_fairmont_managed_hotel/",
    "price_per_night": 1451,
    "total": 2902,
    "taxes_at_hotel": [
      {
        "name": "city_tax",
        "amount": 80.5,
        "currency": "GBP"
      }
    ],
    "currency": "USD",
    "sold_out": false,
    "availability": "available",
    "is_soldout": false,
    "provenance": {
      "schema_version": 1,
      "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
      "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
      "observed_at": "2026-08-07T01:23:45.678Z",
      "source": "zenhotels",
      "source_kind": "ota_rate_plan",
      "source_property_id": "the_savoy_a_fairmont_managed_hotel",
      "requested_currency": "USD",
      "returned_currency": "USD",
      "price_basis": "stay_shown_taxes_included_hotel_taxes_excluded",
      "derivation": "normalized_upstream",
      "upstream_rate_id": "h-a5ff6ba3-909c-543b-87ec-8c65e797bf8b"
    },
    "rooms": [
      {
        "name": "Deluxe Double room (full double bed) (king size bed)",
        "room_code": "3602302",
        "available": true,
        "cheapest_price": 1451,
        "rate_plans": [
          {
            "rate_id": "h-a5ff6ba3-909c-543b-87ec-8c65e797bf8b",
            "room_code": "3602302",
            "name": "Deluxe Double room (full double bed) (king size bed)",
            "price": 1451,
            "total": 2902,
            "currency": "USD",
            "taxes_included": [
              {
                "name": "vat",
                "amount": 483.67,
                "currency": "USD"
              }
            ],
            "taxes_at_hotel": [
              {
                "name": "city_tax",
                "amount": 80.5,
                "currency": "GBP"
              }
            ],
            "meal": [
              "nomeal"
            ],
            "pay_at_hotel": false,
            "provenance": {
              "schema_version": 1,
              "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
              "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
              "observed_at": "2026-08-07T01:23:45.678Z",
              "source": "zenhotels",
              "source_kind": "ota_rate_plan",
              "source_property_id": "the_savoy_a_fairmont_managed_hotel",
              "requested_currency": "USD",
              "returned_currency": "USD",
              "price_basis": "stay_shown_taxes_included_hotel_taxes_excluded",
              "derivation": "normalized_upstream",
              "upstream_rate_id": "h-a5ff6ba3-909c-543b-87ec-8c65e797bf8b"
            },
            "rate_category": "advance_purchase",
            "rate_category_source": "brand_flag",
            "refundable": false,
            "meal_plan": "room_only"
          }
        ]
      }
    ]
  },
  "resolved": {
    "matched_from": "name",
    "slug": "the_savoy_a_fairmont_managed_hotel",
    "master_id": 7801627,
    "name": "The Savoy",
    "city": "London",
    "country_code": "GB",
    "address": "The Strand  WC2R 0EZ",
    "place": "united_kingdom/london",
    "candidates": [
      {
        "slug": "the_savoy_a_fairmont_managed_hotel",
        "master_id": 7801627,
        "name": "The Savoy",
        "city": "London",
        "country_code": "GB",
        "address": "The Strand  WC2R 0EZ",
        "place": "united_kingdom/london"
      }
    ]
  },
  "meta": {
    "source": "zenhotels",
    "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
    "observed_at": "2026-08-07T01:23:45.678Z",
    "nights": 2,
    "adults": 2,
    "elapsed_s": 1.21,
    "total_rate_plans": 72,
    "notes": "`total` is the stay for every room with the taxes the rate shows. Taxes paid at the hotel (city tax, resort fee) are in `taxes_at_hotel`, sometimes in the hotel's own currency; `total_with_hotel_taxes` adds them when they are in the stay's currency."
  }
}

Try it on your key

Good to know

  • Taxes paid at the hotel are added into an all-in figure only when they are in the stay's currency.

Each booking site's own rooms, rate plans and reviews.

Or browse every data source.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support