Hotelovia for developers
Query the lodging directory with one API key.
Build travel discovery and research workflows on published Hotelovia place records: hotels, hostels, guesthouses, holiday apartments, rural houses and campsites in Spain and the United Kingdom, with more countries as their data is published.
curl 'https://www.hotelovia.com/api/v1/places?country=es&city=madrid&lodgingType=hotel' \
--header 'X-API-Key: htl_live_your_key'Purpose-built search
Filter by country, city, lodging type, free text, verification, and technical WhatsApp reachability.
Safe credentials
Secrets are shown once. Hotelovia persists only a SHA-256 hash and lets you revoke a key instantly.
REST and MCP
Use the same credential from your backend, scripts, or an AI client connected to Hotelovia MCP.
API keys
Create a server-side credential
Keep keys in a secrets manager or environment variable. Never embed one in browser code, mobile applications, logs, or source control.
Sign in to manage API keys
Any Hotelovia account can create up to five keys.
REST API
Start with one request
Send the key in X-API-Key. Responses contain only explicitly projected public directory fields and an opaque cursor.
curl 'https://www.hotelovia.com/api/v1/places?country=es&city=madrid&lodgingType=hotel' \
--header 'X-API-Key: htl_live_your_key'Model Context Protocol
Give an agent lodging search
Connect the remote MCP server with the same API key as a Bearer token. It exposes read-only search_places and get_place tools.
{
"mcpServers": {
"hotelovia": {
"type": "http",
"url": "https://mcp.hotelovia.com/mcp",
"headers": {
"Authorization": "Bearer htl_live_your_key"
}
}
}
}Outreach responsibility
whatsappEligible means the published phone appears technically capable of receiving WhatsApp messages. It is not consent, an opt-in, or permission to send marketing. You are responsible for applicable privacy, electronic-communications, and WhatsApp platform rules.