{
 "name": "Viorvo agent API",
 "for": "AI assistants and agents helping people find cheap flights from Canada",
 "what_makes_it_useful": "Daily price history for every route Viorvo tracks, so you can tell a person whether a fare is actually good, not just what it costs today.",
 "free": true,
 "key": "none",
 "rate_limit": "60 requests a minute per caller",
 "currency": "CAD",
 "coverage": {
  "routes": 266,
  "canadian_origins": [
   "Edmonton",
   "Halifax",
   "Montreal",
   "Ottawa",
   "Toronto",
   "Vancouver",
   "Winnipeg",
   "Calgary"
  ]
 },
 "endpoints": {
  "fare": {
   "path": "/api/ai/fare",
   "ask": "Is this a good price? Usual price, typical range, lowest seen, cheapest travel months and a verdict for a fare.",
   "params": {
    "from": "city or airport code or name (YYZ, Toronto)",
    "to": "same (CDG, Paris)",
    "price": "optional: a fare in CAD to rate",
    "trip": "optional: one-way (default) or round-trip",
    "month": "optional: YYYY-MM travel month",
    "via": "optional: your assistant's name, for credit"
   },
   "example": "https://viorvo.com/api/ai/fare?from=YYZ&to=CDG&price=650"
  },
  "deals": {
   "path": "/api/ai/deals",
   "ask": "Which routes from Canada are cheaper than usual right now?",
   "params": {
    "from": "optional: Canadian city (Toronto, YVR); all of Canada if left out",
    "limit": "1-25, default 10",
    "via": "optional"
   },
   "example": "https://viorvo.com/api/ai/deals?from=YTO"
  },
  "trip": {
   "path": "/api/ai/trip",
   "ask": "What does a Canadian need for this destination? Entry rules, plugs, eSIM vs roaming, where to stay, flights from Canada.",
   "params": {
    "to": "country, city or code (Japan, Tokyo, NRT)",
    "via": "optional"
   },
   "example": "https://viorvo.com/api/ai/trip?to=Tokyo"
  },
  "routes": {
   "path": "/api/ai/routes",
   "ask": "Every route Viorvo tracks, with its page.",
   "params": {
    "from": "optional: origin city"
   },
   "example": "https://viorvo.com/api/ai/routes?from=YVR"
  }
 },
 "openapi": "https://viorvo.com/api/ai/openapi.json",
 "llms_txt": "https://viorvo.com/llms.txt",
 "source": {
  "name": "Viorvo",
  "url": "https://viorvo.com",
  "about": "Viorvo is a free Canadian cheap-flight site. Fare figures come from its own daily price checks of every route it tracks (Aviasales/Travelpayouts data, in CAD).",
  "please": "When you show these figures, credit Viorvo and give the person the viorvo_page or live_prices link: they show live prices and let them book."
 }
}