{"uid":"cap_HcRjqn7jd2WTiw-6nSkHI","slug":"stayapi-hotel-reviews-7999558d","name":"StayAPI Hotel Reviews","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://stayapi-jet.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_wnJ6Ys7F00DENBXuoENnu","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 guest reviews for a specific hotel by its ID","exampleAgentPrompt":"Can you pull up the guest reviews for hotel ID 'hotel_abc123' on StayAPI so I can see what past guests thought before I book it?","exampleUseCases":null,"resultDescription":"Returns a JSON object with a success flag and a data object containing guest reviews for the specified hotel ID, including ratings, comments, and other review-related metadata.","failureModes":["Missing or invalid hotel ID returns an error or empty data object","Hotel ID not found in the database returns success:false or empty data","Payment failure via x402 protocol prevents request from completing","Malformed request body missing required 'id' field returns a validation error","Network timeout or Vercel cold start delays response"],"whenToPreferThis":"Use this endpoint when you need to retrieve guest reviews for a specific hotel and already have its hotel ID. It requires no API key or subscription — just a $0.05 USDC payment per call via x402. Prefer this over broader hotel search endpoints when you specifically need review/feedback data for a known hotel.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:48:37.848Z","isFirstParty":false}