GET

WeHotel (Jin Jiang) Hotel Details API

Hydrate one WeHotel (Jin Jiang) property in Chinese or English.

Overview

Get public WeHotel (Jin Jiang) property content, policies, location, contact information, review summary, photos, facilities, services, and static room metadata.

Scope

Details is content-only. Use Rooms with stay dates for live availability and rates. English values fall back to Chinese when the upstream field has no English translation.

Authentication

Send your StayAPI key in the X-API-Key header. Successful requests return JSON; failures use RFC 7807 Problem Details.

Endpoint URL

GET https://api.stayapi.com/v1/bestwe/hotel/details

Parameters

Parameter	Type	Required	Description
property_id	string	Required	Stable WeHotel (Jin Jiang) property identifier returned by Search, for example JJ1089.
language	enum	Optional	Localized content language: zh or en. Default: zh; missing fields fall back to the other language.

Response schema

Field	Type	Description
property_id / hotel_code	string	Stable drilldown identifier and upstream chain code.
name / brand / description / policy	mixed	Localized property identity and published content.
address / city / province / country / location	mixed	Postal and coordinate data.
rating / review_count / star_rating	number	Published guest score and classification.
images / facilities / services	array	Unique public image URLs and localized amenity names.
room_types	array	Static room code, name, description, area, and maximum occupancy.

Errors and limitations

Errors use RFC 7807 Problem Details with provider: "bestwe", a product name, and a correlation id.

400: invalid dates, an incomplete coordinate pair, or child ages that do not match the child count.
404: the WeHotel (Jin Jiang) property identifier is not recognized.
422: a parameter is outside its declared range or enum.
502: WeHotel (Jin Jiang) rejected or failed the upstream request.
503: service temporarily unavailable; honor Retry-After.

Related WeHotel (Jin Jiang) endpoints

Search and get a property id Resolve a WeHotel (Jin Jiang) property URL locally Property content and static room metadata Guest reviews, photos, tags, and hotel replies Live room rates and availability

Request

curl -G "https://api.stayapi.com/v1/bestwe/hotel/details" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "property_id=JJ1089" \
  --data-urlencode "language=en"

const params = {"property_id":"JJ1089","language":"en"};
const search = new URLSearchParams();
Object.entries(params).forEach(([key, value]) => {
  (Array.isArray(value) ? value : [value]).forEach(item => search.append(key, item));
});
const response = await fetch("https://api.stayapi.com/v1/bestwe/hotel/details?" + search, {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.stayapi.com/v1/bestwe/hotel/details",
    params={"property_id":"JJ1089","language":"en"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

Response

{
  "success": true,
  "property_id": "JJ1089",
  "hotel_code": "JJ",
  "name": "Jin Jiang Tower Shanghai",
  "brand": {
    "code": "JINJIANG",
    "name": "Jin Jiang Hotels"
  },
  "address": "161 Changle Road, Shanghai",
  "city": "Shanghai",
  "country": "China",
  "country_code": "CN",
  "location": {
    "latitude": 31.226964,
    "longitude": 121.46954
  },
  "currency": "CNY",
  "foreign_guests_supported": true,
  "pets_allowed": false,
  "images": [
    "https://images.bestwehotel.com/example.jpg"
  ],
  "facilities": [
    "Swimming pool"
  ],
  "services": [
    "Front desk"
  ],
  "room_types": [
    {
      "code": "DBL",
      "name": "Deluxe Room",
      "area_sqm": "30",
      "max_occupancy": 2
    }
  ]
}