{"uid":"cap_XJWdTos8G6H60ri9lZWCO","slug":"rafid-intelligence-network-hotel-search-api-fd66a144","name":"Rafid Intelligence Network — Hotel Search API","description":"Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.","url":"https://api.rafidsystem.com/api/v1/x402/travel/hotel-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":20,"maximum":50,"minimum":1},"adults":{"type":"integer","default":1,"maximum":9,"minimum":1},"checkIn":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"checkOut":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"children":{"type":"integer","default":0,"maximum":8,"minimum":0},"currency":{"type":"string","default":"USD","pattern":"^[A-Z]{3}$"},"childAges":{"type":"array","items":{"type":"integer","maximum":17,"minimum":0},"default":[],"maxItems":8},"destination":{"type":"string","pattern":"^[\\p{L}\\p{N} .,'()-]+$","maxLength":100,"minLength":2},"nationality":{"type":"string","pattern":"^[A-Z]{2}$"}}},"responseSchema":{"type":"json","example":{"count":0,"hotels":[],"dataMode":"live","provider":{"name":"letsfg","status":"ok","upstreamLatencyMs":0},"searchedAt":"2026-10-04T00:00:00.000Z","destination":{"query":"Dubai","resolvedName":"Dubai"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MxndT0RuEAZjs8SRgaq9E","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for available hotels at a destination for given dates, guest count, and currency, returning live availability results.","exampleAgentPrompt":"Search for hotels in Dubai for 2 adults and 1 child aged 8, checking in on 2025-06-10 and checking out on 2025-06-15, show me up to 20 results priced in USD.","exampleUseCases":[{"title":"Family vacation hotel search","prompt":"Find hotels in Orlando for 2 adults and 2 kids aged 6 and 9, checking in June 20 and checking out June 27 — show up to 20 options priced in USD."},{"title":"Solo business traveler lookup","prompt":"Search for hotels in Singapore for 1 adult checking in March 5 and checking out March 8, prices in SGD, limit to 10 results."},{"title":"Couples weekend getaway","prompt":"What hotels are available in Paris for 2 adults from April 18 to April 21? Show up to 15 results in EUR."}],"resultDescription":"Returns a JSON object containing a list of hotel results with count, destination query and resolved name, data mode (live), provider name and status, upstream latency in milliseconds, and the timestamp of the search. Hotel array may be empty if no availability is found.","failureModes":["Empty hotel array returned if no availability at destination for given dates","Invalid date format (not YYYY-MM-DD) causes validation error","Destination string too short or containing invalid characters rejected","Child count and childAges array length mismatch may cause errors","Upstream provider ('letsfg') outage returns provider status error","Limit exceeds maximum of 50 causes schema validation failure","Invalid currency code (not 3 uppercase letters) rejected","Invalid nationality code (not 2 uppercase letters) rejected"],"whenToPreferThis":"Use this endpoint when an AI agent needs live hotel availability and pricing for a specific destination and date range, especially within travel planning, itinerary building, or accommodation booking workflows. It is well-suited for agents that need structured hotel data with guest configuration (adults, children with ages) and currency localization. Prefer this over general web search when structured, machine-readable hotel results are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:03:57.142Z","isFirstParty":false,"canonicalSlug":"rafid-intelligence-network-hotel-search-api-fd66a144"}