{"uid":"cap_fxMm1cWOhzjbko22IErEL","slug":"roam-accommodation-search-by-amenities-661ec5f8","name":"Roam Accommodation Search by Amenities","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://rao-m.vercel.app/api/perks","method":"POST","headers":{},"bodySchema":{"type":"object","required":["amenities"],"properties":{"amenities":{"type":"array","description":"List of amenities to search for"}}},"responseSchema":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object"},"success":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6xYkiOfzX_DxUK8R3VRgh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for accommodation options matching a specified list of amenities, paid per request in USDC via x402.","exampleAgentPrompt":"Find me accommodations that have a pool, free WiFi, and a gym — I want to see what's available with those specific amenities.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a success boolean and a data object containing accommodation listings or property details that match the requested amenities.","failureModes":["Missing required 'amenities' array returns a validation error","Empty amenities array may return no results or an error","Payment failure via x402 (insufficient USDC balance) blocks the request","Upstream accommodation data unavailable returns an error or empty data","Invalid amenity strings that don't match known amenity types may return empty results"],"whenToPreferThis":"Use this endpoint when you need to search for accommodations filtered by specific amenities without requiring API keys or subscriptions — ideal for AI agent workflows that need pay-per-use accommodation discovery via crypto micropayments (x402/USDC). Best when the user's primary filter criterion is a set of desired amenities rather than location or date.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:23.035Z","isFirstParty":false}