GET

WeHotel (Jin Jiang) Search API

Find WeHotel (Jin Jiang) properties in a Chinese destination.

Overview

Search dated WeHotel (Jin Jiang) inventory by city code, with property identifiers and lowest advertised nightly prices.

Scope

Search names come from the upstream Chinese search API. property_id is the stable identifier for Details and Rooms. Prices are anonymous web prices in CNY and may include publicly exposed club plans.

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/search

Parameters

Parameter	Type	Required	Description
city_code	string	Required	WeHotel (Jin Jiang) city identifier, 3 to 32 alphanumeric characters; AR04567 is Shanghai.
check_in	date	Required	Check-in date (YYYY-MM-DD). Cannot be in the past.
check_out	date	Required	Check-out date (YYYY-MM-DD), after check-in.
latitude	number	Optional	Optional search-center latitude (-90 to 90). Must be supplied with longitude.
longitude	number	Optional	Optional search-center longitude (-180 to 180). Must be supplied with latitude.
page	integer	Optional	Upstream page number, at least 1. Default: 1.
limit	integer	Optional	Results per page, 1 to 20. Default: 10.
sort	enum	Optional	recommended, distance, price_asc, or price_desc. Default: recommended.

Response schema

Field	Type	Description
hotels	array	Properties with property_id, hotel code, Chinese name, brand, address, coordinates, ratings, photo, room signal, labels, and lowest CNY price.
total	integer	Total upstream records for the city search.
page_info	object	Page, page size, total pages, and has_next_page.

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/search" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "city_code=AR04567" \
  --data-urlencode "check_in=2026-08-10" \
  --data-urlencode "check_out=2026-08-11" \
  --data-urlencode "latitude=31.2304" \
  --data-urlencode "longitude=121.4737" \
  --data-urlencode "sort=distance"

const params = {"city_code":"AR04567","check_in":"2026-08-10","check_out":"2026-08-11","latitude":31.2304,"longitude":121.4737,"sort":"distance"};
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/search?" + search, {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.stayapi.com/v1/bestwe/search",
    params={"city_code":"AR04567","check_in":"2026-08-10","check_out":"2026-08-11","latitude":31.2304,"longitude":121.4737,"sort":"distance"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

Response

{
  "success": true,
  "hotels": [
    {
      "property_id": "JJ1089",
      "hotel_code": "1089",
      "name": "上海新锦江大酒店",
      "brand_code": "JINJIANG",
      "address": "上海市黄浦区长乐路161号",
      "location": {
        "latitude": 31.226964,
        "longitude": 121.46954
      },
      "distance_km": 0.6,
      "rating": 4.8,
      "star_rating": 4.0,
      "has_rooms": true,
      "foreign_guests_supported": true,
      "price": {
        "per_night": 610.0,
        "currency": "CNY"
      }
    }
  ],
  "total": 252,
  "page_info": {
    "page": 1,
    "page_size": 10,
    "total_pages": 26,
    "has_next_page": true
  }
}