GET

Best We Hotel Reviews API

Pull rich guest feedback for one Best We property.

Overview

Get public Best We guest reviews with pagination, score dimensions, photos, popular tags, room breakdowns, and hotel responses.

Scope

Reviews are returned in Best We's published language, normally 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 Best We 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: Best We rejected or failed the upstream review 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/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
  }
}