{"uid":"cap_7Ho-v1eS3qGUPWOwCyEpw","slug":"stayapi-hotel-reviews-98374c32","name":"StayAPI Hotel Reviews","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://stayagent.vercel.app/api/reviews","method":"POST","headers":{},"bodySchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Hotel ID"}}},"responseSchema":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object"},"success":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Us9U3hCsavtdTxa-43Hnz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves user reviews for a specific hotel by its ID","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:41:56.867Z","isFirstParty":false}