GET

Best We Hotel Details API

Hydrate one Best We property in Chinese or English.

Overview

Get public Best We 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 Best We 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 Best We property identifier is not recognized.
422: a parameter is outside its declared range or enum.
502: Best We rejected or failed the upstream request.
503: bounded scraper capacity is temporarily full; honor Retry-After.

Related Best We endpoints

Search and get a property id Resolve a Best We 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
    }
  ]
}