GET

WeHotel (Jin Jiang) Hotel Reviews API

Pull rich guest feedback for one WeHotel (Jin Jiang) property.

Overview

Get public WeHotel (Jin Jiang) guest reviews with pagination, score dimensions, photos, popular tags, room breakdowns, and hotel responses.

Scope

Reviews are returned as published by WeHotel (Jin Jiang), normally in Chinese. page is one-based. The filter selects all, good, bad, or photo reviews without extra upstream calls.

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

Parameters

Parameter	Type	Required	Description
property_id	string	Required	Stable WeHotel (Jin Jiang) property identifier returned by Search, for example JJ1089.
page	integer	Optional	Page number, at least 1. Default: 1.
page_size	integer	Optional	Reviews per page, 1 to 20. Default: 10.
filter	enum	Optional	all, good, bad, or photos. Default: all.

Response schema

Field	Type	Description
rating / total	number	Overall property score and total published review count.
filter / filter_counts	mixed	Active review subset and counts for all, good, bad, and photo reviews.
tags / room_types	array	Popular review-tag counts and review counts by room type.
reviews	array	Review id, score, text, timestamp, masked reviewer, room, trip type, helpful count, photos, dimension scores, and hotel responses.
page_info	object	One-based page, page size, total pages for the active filter, and has_next_page.

Errors and limitations

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

422: property_id, page, page_size, or filter is outside its declared contract.
502: WeHotel (Jin Jiang) rejected or failed the upstream review 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/reviews" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "property_id=JJ1089" \
  --data-urlencode "page=1" \
  --data-urlencode "page_size=10" \
  --data-urlencode "filter=photos"

const params = {"property_id":"JJ1089","page":1,"page_size":10,"filter":"photos"};
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/reviews?" + 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/reviews",
    params={"property_id":"JJ1089","page":1,"page_size":10,"filter":"photos"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
print(response.json())

Response

{
  "success": true,
  "property_id": "JJ1089",
  "rating": 4.8,
  "total": 1420,
  "filter": "photos",
  "filter_counts": {
    "all": 1420,
    "good": 1323,
    "bad": 43,
    "photos": 89
  },
  "tags": [
    {
      "id": "10",
      "name": "位置极佳",
      "count": 731
    }
  ],
  "room_types": [
    {
      "code": "FT",
      "name": "高级双床房",
      "count": 182
    }
  ],
  "reviews": [
    {
      "id": "68d3a27addc4bb51baa32ccd",
      "rating": 3.0,
      "content": "太破旧了！",
      "reviewed_at": "2025-09-24T05:09:14.086Z",
      "reviewer_name": "31***33",
      "room_type_code": "FT",
      "room_type_name": "高级双床房",
      "travel_type": "其他",
      "helpful_count": 0,
      "photos": [
        "https://imgs.bestwehotel.com/images/comment/example"
      ],
      "scores": [
        {
          "category_code": 1001,
          "category": "服务评分",
          "score": 3.0
        }
      ],
      "hotel_responses": []
    }
  ],
  "page_info": {
    "page": 1,
    "page_size": 10,
    "total_pages": 9,
    "has_next_page": true
  }
}