{"uid":"cap_YwM9RFxzVV8PPQuZdnhmJ","slug":"roam-hotel-takeaways-8d7ac1ce","name":"Roam Hotel Takeaways","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://raomv3.vercel.app/api/takeaways?utm_source=zero.xyz","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":"registry","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_JD6t9IWpELQTt0pv7CEOI","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 detailed takeaway/summary data for a specific hotel by ID, enabling AI agents to access accommodation details without subscriptions","exampleAgentPrompt":"Can you pull up the full details for hotel ID 'HTL-20483' using Roam so I can see what that property offers?","exampleUseCases":[{"title":"Travel agent fetching hotel details","prompt":"I'm looking at hotel ID 'NYC-8821' for my client's trip — can you grab all the details on that property from Roam so I can see what's included?"},{"title":"Comparing specific shortlisted hotels","prompt":"I've narrowed it down to hotel 'LON-4492' — pull up its full summary from Roam so I can decide if it's worth booking."},{"title":"Automated itinerary enrichment","prompt":"For my itinerary builder, fetch the accommodation details for hotel ID 'PAR-3310' from Roam and include them in the trip summary."}],"resultDescription":"Returns a structured data object containing hotel details and summary information (takeaways) for the requested hotel ID, along with a success boolean indicating whether the lookup was completed successfully.","failureModes":["Invalid or unknown hotel ID returns success: false with empty or error data","Malformed request missing required 'id' field results in a 400-level error","Payment failure via x402 protocol prevents access to the endpoint","Vercel cold start or infrastructure downtime causes delayed or failed responses","Hotel ID format mismatch (wrong schema) leads to no-result response"],"whenToPreferThis":"Choose this endpoint when you already have a specific hotel ID and need to retrieve its detailed summary data in a pay-per-use model without API keys or subscriptions. It is ideal for AI agents building travel itineraries, comparing specific shortlisted properties, or enriching booking workflows with hotel details on demand. Prefer this over general search endpoints when the hotel identifier is already known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:42:00.848Z","isFirstParty":false,"canonicalSlug":"roam-hotel-takeaways-8d7ac1ce"}