# Hotel Guest Reviews by Property Token

> Hotel Guest Reviews by Property Token is a paid API for AI agents from hotels.use.x402atlas.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Fetches paginated guest reviews for a specific hotel, including ratings, review text, per-aspect subratings, highlights, and the property owner's reply.

## Facts

- Endpoint: GET https://hotels.use.x402atlas.com/reviews
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hotel-guest-reviews-by-property-token-439186a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IiHfkJAbzFKG3jOcF8srn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hotel-guest-reviews-by-property-token-439186a8
```

Example prompt: Can you pull up the guest reviews for the Marriott Times Square — I need ratings, review snippets, any owner replies, and the per-aspect scores like rooms and service? The property token is ChIJN1t_tDeuEmsRUsoyG83frY4.

## When to prefer this

Use this endpoint when you have a specific hotel's property_token (obtained from the /hotels/search sibling endpoint) and need detailed guest sentiment data — including per-aspect subratings, owner replies, and categorized highlights — rather than just summary star scores. Prefer this over generic review scrapers when you need structured, paginated, multi-source review data with language control.

## Known failure modes

- Missing or invalid property_token returns an error or empty reviews array
- Property token from a non-hotel or expired search result may yield no data
- Unsupported language code for 'hl' may fall back to English or return an error
- Rate limiting or payment failure results in a 402 or 429 response
- Truncated response if review count is very large and paging parameters are not used

## How this service works

Hotel reviews — a hotel's guest reviews by property token: rating, date, text, per-aspect subratings, highlights & the owner's reply, with category filter & paging.

## Output

Returns an array of guest review objects, each containing: review text snippet, overall integer rating and maximum scale, review date, reviewer name and profile link, source platform, per-aspect subratings (rooms, service, location), hotel highlights array, and the property's owner reply (date + text) if present. Also includes the query timestamp and total source count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "property_token"
     ],
     "properties": {
      "hl": {
       "type": "string",
       "default": "en",
       "maxLength": 5,
       "description": "Language code for the reviews"
      },
      "property_token": {
       "type": "string",
       "minLength": 1,
       "description": "Property token from a /hotels/search result"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "property_token",
      "reviews"
     ],
     "properties": {
      "reviews": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": "string"
         },
         "user": {
          "type": "object",
          "properties": {
           "link": {
            "type": "string"
           },
           "name": {
            "type": "string"
           },
           "thumbnail": {
            "type": "string"
           }
          }
         },
         "rating": {
          "type": "integer"
         },
         "source": {
          "type": "string"
         },
         "snippet": {
          "type": "string",
          "description": "The review text"
         },
         "response": {
          "type": "object",
          "properties": {
           "date": {
            "type": "string"
           },
           "snippet": {
            "type": "string"
           }
          },
          "description": "The property's reply"
         },
         "attributes": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "name": {
             "type": "string"
            },
            "snippet": {
             "type": "string"
            }
           }
          }
         },
         "subratings": {
          "type": "object",
          "properties": {
           "rooms": {
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "reviews": [
   {
    "date": "4 months ago",
    "user": {
     "link": "https://www.google.com/maps/contrib/100815052880274933640?hl=en",
     "name": "Ramandeep kaur"
    },
    "rating": 4,
    "source": "Google",
    "snippet": "What a beautiful place to stay! The location is perfect. The breakfast buffet was amazing — huge and full of variety. The pool area is absolutely beautiful and a perfect spot to unwind.",
    "subratings": {
     "rooms": 4,
     "service": 4,
     "location": 5
    },
    "best_rating": 5,
    "hotel_highlights": [
     "Romantic"
    ]
   }
  ],
  "queried_at": "2026-07-25T12:00:00Z",
  "property_token": "ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
  "next_page_token": "CjEIARIpCgoAP7_LACda____EhCB3gky7h3XYNgvXm4AAAAAGgn92PoCYUlVH7AYACIA:10"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hotel-guest-reviews-by-property-token-439186a8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hotels.use.x402atlas.com](https://www.zero.xyz/host/hotels.use.x402atlas.com/llms.txt)