← HotelSage

HotelSage API

Free, no-auth API that recommends real hotels anywhere in the world for a natural-language request and returns a booking link per hotel. Same engine as the HotelSage chat (Gemini). Rate limit: 60 requests/hour per IP. CORS enabled for GET.

1. REST

GET https://hotelsage.io/api/v1/recommend?q=hotel%20boutique%20en%20Lisboa&lang=es

Parameters: q (required, the request in any language, ≤600 chars) · lang = es | en (answer language).

{
  "query": "hotel boutique en Lisboa",
  "lang": "es",
  "answer": "…short conversational answer…",
  "hotels": [
    {"name": "…", "city": "Lisboa", "country": "Portugal", "why": "…",
     "url": "https://hotelsage.io/go?…", "source": "booking_cj", "direct_booking": false}
  ],
  "followup": null,
  "disclosure": "…"
}

Errors: 400 missing q · 429 rate limit · 503 model busy (retry).

2. OpenAPI 3.1 — add it as a ChatGPT Action

Spec: https://hotelsage.io/openapi.json

  1. In ChatGPT → Explore GPTs → Create → Configure → Actions → Create new action.
  2. Choose Import from URL and paste https://hotelsage.io/openapi.json. Authentication: None.
  3. Save. The GPT now has the recommendHotels operation; tell it in the instructions to show each hotel's url as the booking link.

Works the same with any OpenAPI-aware agent framework (LangChain, Vertex AI Agent Builder, Dify, etc.).

3. MCP server (Model Context Protocol)

Endpoint: POST https://hotelsage.io/mcp — Streamable HTTP transport, JSON-RPC 2.0, stateless, no auth. One tool: recommend_hotels {query: string, lang?: "es"|"en"}.

Claude Desktop / Claude Code (claude mcp add --transport http hotelgpt https://hotelsage.io/mcp), Cursor, Windsurf, ChatGPT connectors and any MCP client that supports remote HTTP servers can add it by URL.

curl -s https://hotelsage.io/mcp -H 'Content-Type: application/json' -d '{
  "jsonrpc":"2.0","id":1,"method":"tools/call",
  "params":{"name":"recommend_hotels","arguments":{"query":"hotel en Lisboa con vista","lang":"es"}}
}'

Other methods: initialize, ping, tools/list. The response carries a readable content[0].text with links plus the same JSON as the REST API in structuredContent.

4. Discovery for AI crawlers

/llms.txt · /sitemap.xml · city hotel guides · guides by trip type

Terms

Free for personal and commercial use within the rate limit. Booking links are HotelSage affiliate links (the traveller pays the same price). Recommendations are AI-generated and may contain errors; prices and availability are confirmed on the booking page. Contact: apps@brainystack.co — Adwertz Media.