# StayAPI Hotel Reviews

> StayAPI Hotel Reviews is a paid API for AI agents from stayagent.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Retrieves user reviews for a specific hotel by its ID

## Facts

- Endpoint: POST https://stayagent.vercel.app/api/reviews
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stayapi-hotel-reviews-98374c32
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Ho-v1eS3qGUPWOwCyEpw

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 stayapi-hotel-reviews-98374c32 -d '<json body>'
```

Example prompt: Can you pull up all the guest reviews for hotel ID 'hotel_nyc_plaza_001' on StayAPI so I can see what people are saying before I book?

## When to prefer this

Use this endpoint when you have a specific hotel ID and need to retrieve guest reviews or feedback for that property. Prefer this over general search endpoints when you already know which hotel you're evaluating and want social proof or quality signals from past guests.

## Known failure modes

- Missing or invalid hotel ID returns an error or empty data
- Hotel ID not found in the database returns a failed success flag
- Network or payment processing failure via x402 returns a 402 or connectivity error
- Malformed request body without the required 'id' field returns a validation error

## How this service works

Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.

## Output

Returns a JSON object with a success boolean and a data object containing review information for the specified hotel, such as guest ratings, written feedback, and related metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string",
   "description": "Hotel ID"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object"
  },
  "success": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stayapi-hotel-reviews-98374c32/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stayagent.vercel.app](https://www.zero.xyz/host/stayagent.vercel.app/llms.txt)