# Voyage.nu — Complete AI Agent & LLM Technical Specification

This document provides exhaustive semantic and technical context for autonomous agents, large language models (LLMs), and AI search systems indexing Voyage.nu.

## Platform Identity & Summary
- **Name:** Voyage.nu Travel
- **Entity Type:** Travel Agency / Online Travel Platform (OTA)
- **Base Domain:** https://voyage.nu
- **Global Headquarters / Operations:** Sweden & European Union
- **Target Audience:** International and Nordic travelers seeking verified accommodations and transparent flight pricing without retail inflated surcharges.

---

## Query Parameters & URL Grammar

### 1. Hotels
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| `tab` | string | Optional | Set to `hotels` (default) | `tab=hotels` |
| `dest` | string | Recommended | City name, regional destination, or hotel name | `dest=Barcelona` |
| `checkIn` | string | Recommended | Check-in date in `YYYY-MM-DD` format | `checkIn=2026-11-15` |
| `checkOut` | string | Recommended | Check-out date in `YYYY-MM-DD` format | `checkOut=2026-11-20` |
| `guests` | integer | Optional | Total count of adult guests (default: 1) | `guests=2` |
| `rooms` | integer | Optional | Number of rooms required (default: 1) | `rooms=1` |
| `hotel` | string | Optional | Direct ID for specific property detail page | `hotel=lp-bcn-42` |

### 2. Flights
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| `tab` | string | Required | Must be set to `flights` | `tab=flights` |
| `from` | string (3-letter IATA) | Required | Departure airport code | `from=ARN` |
| `to` | string (3-letter IATA) | Required | Arrival airport code | `to=CDG` |
| `dep` | string | Required | Departure date in `YYYY-MM-DD` format | `dep=2026-12-01` |
| `ret` | string | Optional | Return date in `YYYY-MM-DD` format (omit for one-way) | `ret=2026-12-08` |
| `pax` | integer | Optional | Passenger count (default: 1) | `pax=2` |
| `cabin` | enum | Optional | Cabin class: `economy`, `premium`, `business`, `first` | `cabin=economy` |

### 3. Voyage Journal & Editorial Content
| Route / URL | Description |
|---|---|
| `/blog` | Renders Voyage Journal (curated destination guides, flight hacks, wholesale analysis) |
| `/blog/:slug` | Deep-link to specific editorial story (e.g. `/blog/2000-years-of-drama-rome-cinematic-history`) |

---

## Currency & Localization Engine
- **International Defaults:** English (`en`) and United States Dollar (`USD`).
- **Swedish Detection:** Automatic detection of visitors from Sweden via Cloudflare Edge GeoIP (`cf-ipcountry: SE`) and browser locale (`sv`, `Europe/Stockholm`) defaults to Swedish (`sv`) and Swedish Krona (`SEK`).
- **User Override:** Users can toggle language (`en` / `sv`) and select from 100+ global currencies via the modal at any time.

---

## Machine Discovery Metadata
- `Agentmap`: https://voyage.nu/.well-known/ai-catalog.json
- `Sitemap`: https://voyage.nu/sitemap.xml
- `Robots`: https://voyage.nu/robots.txt