Best We Hotel API

The Best We Hotel API for Jin Jiang hotel data, reviews, and live rates.

Pull Best We city search, hotel details, guest reviews, galleries, facilities, room types, inventory, and live CNY rate plans as clean JSON.

REQUEST GET

USE CASE Search Shanghai by its Best We city code, nearest first.

curl "https://api.stayapi.com/v1/bestwe/search" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "city_code=AR04567" \
  -d "check_in=2026-08-10" \
  -d "check_out=2026-08-11" \
  -d "latitude=31.2304" \
  -d "longitude=121.4737" \
  -d "sort=distance"

USE CASE Resolve a public Best We hotel URL before requesting content or rates.

curl "https://api.stayapi.com/v1/bestwe/hotel/url-to-id" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "url=https://hotel.bestwehotel.com/HotelDetail?hotelId=JJ1089&utm_source=example"

USE CASE Get English property content and the static room catalogue.

curl "https://api.stayapi.com/v1/bestwe/hotel/details" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "property_id=JJ1089" \
  -d "language=en"

USE CASE Get the first page of Best We reviews that include guest photos.

curl "https://api.stayapi.com/v1/bestwe/hotel/reviews" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "property_id=JJ1089" \
  -d "page=1" \
  -d "page_size=10" \
  -d "filter=photos"

USE CASE Get dated room inventory and live CNY rate plans.

curl "https://api.stayapi.com/v1/bestwe/hotel/rooms" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "property_id=JJ1089" \
  -d "check_in=2026-08-10" \
  -d "check_out=2026-08-11" \
  -d "adults=2" \
  -d "rooms=1" \
  -d "language=en"

RESPONSE 200 OK

2.41s

{
  "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
  }
}

{
  "success": true,
  "url": "https://hotel.bestwehotel.com/HotelDetail?hotelId=JJ1089",
  "property_id": "JJ1089"
}

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

{
  "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
    }
  ],
  "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"
      ],
      "hotel_responses": []
    }
  ],
  "page_info": {
    "page": 1,
    "page_size": 10,
    "total_pages": 9,
    "has_next_page": true
  }
}

{
  "success": true,
  "property_id": "JJ1089",
  "check_in": "2026-08-10",
  "check_out": "2026-08-11",
  "nights": 1,
  "currency": "CNY",
  "room_types": [
    {
      "code": "DBL",
      "name": "Deluxe Room",
      "available_rooms": 3,
      "bed_types": [
        "King bed"
      ],
      "rates": [
        {
          "code": "BAR",
          "name": "Flexible Rate",
          "per_night": 610.0,
          "stay_total": 610.0,
          "currency": "CNY",
          "prepaid": false,
          "bookable": true,
          "available_rooms": 3,
          "breakfast_included": true,
          "breakfast_count": 2,
          "member_rate": false
        }
      ]
    }
  ],
  "total": 1
}

Start free with 50 requests Read the docs

99.9% uptime ~3s avg response Live, not cached

Trusted by hospitality teams at

Overview

What the Best We Hotel API gives you.

Best We Hotel is the consumer booking platform for Jin Jiang's large hotel portfolio in China, including Jin Jiang, Metropolo, Campanile, Golden Tulip, Lavande, Vienna, 7 Days, and other participating brands. Its public booking flow has the hotel content and direct rates product and revenue teams need, but not a stable self-serve data API.

StayAPI runs that integration for you. Search by a Best We city code, use the returned property_id to hydrate bilingual hotel content and rich guest reviews, then request dated room inventory and public or club rate plans. Every call returns normalized JSON over ordinary authenticated REST.

One property id across the workflow.

Search returns a stable property_id. Pass it unchanged to Details, Reviews, or Rooms; there is no second identifier mapping step.

Chinese-first, bilingual content.

Search reflects the Chinese upstream catalogue. Details and Rooms accept language=zh or language=en, with fallback when a translation is missing.

Live CNY inventory.

Rooms calls Best We live for room-level inventory, public and club plans, breakfast, cancellation, and native CNY pricing.

View pricing View the docs

Endpoints

Every Best We Hotel endpoint, one base URL.

Each returns normalized JSON in the same shape. Click any endpoint for parameters, an example response, and a live playground.

GET Hotel search /v1/bestwe/search Search one Best We city for properties, ratings, coordinates, room signals, and lowest advertised CNY prices. GET URL to Hotel ID /v1/bestwe/hotel/url-to-id Extract the stable property_id from a canonical Best We property URL locally, without an upstream request. GET Hotel details /v1/bestwe/hotel/details Bilingual property content, policies, contact data, reviews summary, images, facilities, services, and static room metadata. GET Hotel reviews /v1/bestwe/hotel/reviews Paginated guest reviews with category scores, photos, popular tags, room breakdowns, and hotel responses. GET Hotel rooms /v1/bestwe/hotel/rooms Dated room inventory and rate plans with CNY totals, breakfast, cancellation, prepayment, and club-rate signals.

Browse the full Best We Hotel docs

Best We Hotel Prices API - Live Rates as JSON Best We Hotel Reviews API - Guest Reviews as JSON

Use cases

What teams build on the Best We Hotel API.

The same endpoints, pointed at different jobs. These are the ones we see most.

China hotel market discovery.

Search a Best We city and compare participating Jin Jiang-family properties on location, rating, star class, room signal, and lowest advertised price.

Brand.com vs OTA rate shopping.

Pull direct Best We room plans for a property and stay, then compare CNY per-night and stay-total pricing with Booking.com, Trip.com, or Expedia.

Room inventory monitoring.

Track room-type availability, quota, public and club plans, and cancellation terms as arrival approaches.

Guest-feedback intelligence.

Paginate all, good, bad, or photo reviews and analyze score dimensions, popular tags, room types, travel purpose, and hotel responses.

Bilingual property catalogues.

Hydrate hotel descriptions, policies, galleries, facilities, services, and room metadata in Chinese or English from one stable property id.

Also over MCP

Best We Hotel data, inside your AI agent.

The same endpoints are exposed as MCP tools. Connect Claude, Cursor, or Claude Code, ask in plain English, and the agent calls the tool and answers from live Best We Hotel data.

See the MCP setup Read the MCP docs

Claude

Summarize recent Best We reviews for Jin Jiang Tower Shanghai, then show live room rates for my dates.

Used bestwe_hotel_reviews 2.41s

Best We returned recent guest reviews with score dimensions and hotel replies. I can now compare the available public and member room plans for your stay.

Pricing

50 free requests on signup.
Pick a plan when you need more.

Flat monthly plans, every endpoint included on every plan. 1 request = 1 credit. No per-endpoint multipliers, no surprise overages.

01 Free

Wire it up. See the schema.

$0 to start

50 free requests on signup
Every endpoint included
No credit card required
Same schema as paid

Start free

02 Basic

Kick the tires in production.

$49 per month

1,500 requests / month
Every endpoint included
Per-endpoint usage dashboard
Email support

Start Basic

What people ask about the Best We Hotel API.

Don't see your question? Email us at info@stayapi.com.

What is Best We Hotel?

Best We Hotel is a Chinese hotel booking platform for Jin Jiang and participating brands such as Metropolo, Campanile, Golden Tulip, Lavande, Vienna, and 7 Days. StayAPI exposes its public hotel search, property content, guest reviews, and live room-rate workflow as normalized REST.

How do I search Best We hotels in Shanghai?

Call /v1/bestwe/search with city_code=AR04567 plus check-in and check-out dates. The response includes a stable property_id for Details, Reviews, and Rooms. See the search docs.

Can the Best We Hotel API return live room rates?

Yes. Call /v1/bestwe/hotel/rooms with a search result's property_id, dates, and occupancy. Each room contains live plans with native CNY pricing, calculated stay total, availability, breakfast, cancellation, prepayment, and club-rate signals. See the rooms docs.

Can I retrieve individual Best We hotel reviews?

Yes. Call Hotel Reviews with a property_id. The endpoint returns paginated guest text, scores, room and travel context, moderated photos, tags, and hotel responses. Use filter=all|good|bad|photos to select a review subset.

How do I get a Best We property ID from a hotel URL?

Pass the canonical hotel.bestwehotel.com/HotelDetail?hotelId=... URL to URL to Hotel ID. StayAPI extracts the identifier locally, strips tracking parameters, and returns the normalized property URL without calling Best We.

Does the Best We Hotel API support English?

Details and Rooms accept language=en or language=zh. When Best We has no value in the requested language, the endpoint falls back to the other language. Search names are supplied in Chinese by the upstream search API.

What currency do Best We rates use?

CNY is the authoritative currency for Best We search and room rates. The public booking surface does not provide arbitrary output-currency conversion, and taxes or service fees are not separately itemized.

Two ways to start.

Both end with live Best We Hotel data in your stack. The fast path is on the left.

01 · the fast path

Try it free

50 free requests after sign up. Fastest way to see if the schema fits.