Hotel Search, Rates & Reviews

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.

Resource: hotels.use.x402atlas.com/reviews

Network: eip155:8453, eip155:137, eip155:42161 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x28410EaC7393dba041cd5a92eEfe7a8E834310bb

Payment methods: — · Last validation: 2026-09-14 16:29:49.628+00

{
  "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": {
                      "type": "integer"
                    },
                    "service": {
                      "type": "integer"
                    },
                    "location": {
                      "type": "integer"
                    }
                  }
                },
                "best_rating": {
                  "type": "integer",
                  "description": "The rating scale's maximum"
                },
                "source_icon": {
                  "type": "string"
                },
                "hotel_highlights": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "queried_at": {
            "type": "string",
            "format": "date-time",
            "description": "Time the lookup ran (UTC)"
          },
          "source_number": {
            "type": "integer",
            "description": "Echoed when the reviews were narrowed to one third-party site"
          },
          "category_token": {
            "type": "string",
            "description": "Echoed when the reviews were narrowed to one theme"
          },
          "property_token": {
            "type": "string"
          },
          "next_page_token": {
            "type": "string",
            "description": "Pass back as next_page_token for the next page"
          }
        }
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "tier": "standard",
          "version": "2",
          "merchant": "x402Atlas"
        },
        "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
        "amount": "20000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "20000"
    },
    {
      "raw": {
        "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
        "extra": {
          "name": "USD Coin",
          "tier": "standard",
          "version": "2",
          "merchant": "x402Atlas"
        },
        "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
        "amount": "20000",
        "scheme": "exact",
        "network": "eip155:137",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
      "scheme": "exact",
      "network": "eip155:137",
      "amountAtomic": "20000"
    },
    {
      "raw": {
        "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "extra": {
          "name": "USD Coin",
          "tier": "standard",
          "version": "2",
          "merchant": "x402Atlas"
        },
        "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
        "amount": "20000",
        "scheme": "exact",
        "network": "eip155:42161",
        "maxTimeoutSeconds": 300
      },
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "payTo": "0x28410EaC7393dba041cd5a92eEfe7a8E834310bb",
      "scheme": "exact",
      "network": "eip155:42161",
      "amountAtomic": "20000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.