{"uid":"cap_4esfDxhqo5qp9xp5SgMSb","slug":"roam-accommodation-perks-search-f1096407","name":"Roam Accommodation Perks Search","description":"Accommodation search for AI agents. No auth, no subscriptions. Pay per request in USDC via x402.","url":"https://raomv3.vercel.app/api/perks?utm_source=zero.xyz","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":"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.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_Lx95DObED2Nef3hY3Rwxv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for accommodations by amenities/perks, returning matching lodging options for AI agents via pay-per-request USDC payment.","exampleAgentPrompt":"Search Roam for accommodations that have a pool, free wifi, and pet-friendly amenities — I need a place that checks all three boxes.","exampleUseCases":[{"title":"Remote worker seeking work-friendly stay","prompt":"Find me accommodations that have fast wifi, a dedicated workspace, and a gym — I'm looking for somewhere I can work and stay healthy during a long trip."},{"title":"Family vacation with must-have amenities","prompt":"Search for lodging options that have a pool, kid-friendly facilities, and a full kitchen — those three are non-negotiable for our family stay."},{"title":"Pet owner finding pet-friendly lodging","prompt":"I need to find accommodations that are pet-friendly and also have outdoor space or a garden — can you search Roam for places that offer both those perks?"}],"resultDescription":"Returns a JSON object with a success boolean and a data object containing accommodation listings or perks data matching the requested amenities. Exact structure of the data object is not fully specified but reflects matching lodging options.","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","No matching accommodations found returns success:true with empty data","Service unavailability on Vercel deployment may return 5xx errors"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to find accommodations filtered by specific amenity requirements without requiring API keys or subscriptions. It is ideal for agentic workflows that need frictionless, pay-per-use lodging search paid in USDC via the x402 protocol. Prefer this over traditional hotel APIs when you want no auth overhead and micro-payment-based access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:45:15.138Z","isFirstParty":false,"canonicalSlug":"roam-accommodation-perks-search-f1096407"}