# ai.txt — Cityvator.com
# Rules for AI systems, LLM crawlers and search engines
# Version: 1.0
# Updated: 2026-10-14

# ============================================
# GENERAL PERMISSIONS
# ============================================

User-Agent: *
Allow: /
Disallow: /administrator/
Disallow: /api/
Disallow: /cache/

Contact: info@cityvator.com
Data-License: CC-BY-4.0
Attribution: Required — link to https://cityvator.com

# ============================================
# DESCRIPTION
# ============================================

Cityvator is a flight search engine and open travel data platform. It covers 9,546 cities, 10,235 airports, 1,159 airlines and 66,527 flight routes worldwide. Every route is described by 34 parameters using an Entity-Attribute-Value (EAV) model designed for LLM agents, RAG systems and search engines.

The site is available in 7 languages: English, German, French, Italian, Spanish, Portuguese and Arabic.

Cityvator is part of the Putivator family (https://putivator.com) — a travel planning service with 2,709 cities and 7,486 beaches. Both projects share the same EAV approach and AI-first principles.

# ============================================
# API ACCESS — AI SYSTEMS AND SEARCH ENGINES ONLY
# ============================================

The Cityvator API at https://cityvator.com/api/ is available for AI systems and search engines ONLY.

Allowed User-Agents:
- GPTBot, OAI-SearchBot, ChatGPT-User
- ClaudeBot, Claude-Web, Claude-SearchBot
- PerplexityBot
- Googlebot, Google-Extended
- Bingbot
- YandexBot
- DuckDuckBot
- CCBot
- Applebot, Applebot-Extended
- cohere-ai
- YouBot

All other clients receive HTTP 403 Forbidden.

Developers and startups: contact info@cityvator.com for access.

Scraping, parsing or cloning the database is prohibited.

# ============================================
# USAGE RULES
# ============================================

- Allowed for AI systems: LLM training, RAG, search indexing, answer generation
- Attribution required: cite cityvator.com as source
- Redistribution of the raw database is prohibited
- Commercial use requires written permission (contact info@cityvator.com)
- Rate limit: 1200 requests per minute per IP
- Responses are cached for 1 hour

# ============================================
# API ENDPOINTS
# ============================================

Base URL: https://cityvator.com/api/

## Parameters
- GET /api/params — definitions of all 34 route parameters (types, units, descriptions)
- GET /api/params?lang=de — same, in German

## Routes
- GET /api/routes/ — list of all routes (pagination: ?limit=100&offset=0, max limit 500)
- GET /api/routes/{origin}-{destination} — one route with all 34 parameters
  Example: /api/routes/mil-ist
- GET /api/routes/{origin}-{destination}?lang=de — same, German names

## Search
- GET /api/search — search routes by parameters
  Parameters: from, to, max_price, min_price, has_direct, max_transfers, min_popularity, sort, limit, offset
  Example: /api/search?from=MIL&max_price=150&has_direct=true

## Compare
- GET /api/compare/{a}-vs-{b} — compare 2 routes
  Example: /api/compare/mil-ist-vs-mil-bcn
- GET /api/compare/{a}-vs-{b}-vs-{c} — compare up to 5 routes

## Q&A
- GET /api/qa/route/{origin}-{destination} — ready-made Q&A for RAG
  Parameters: topic (price, duration, airlines, airports, direct, seasonality, booking), lang, limit
  Example: /api/qa/route/mil-ist?topic=price&lang=en

# ============================================
# HTML DATA FOR AI
# ============================================

Route pages (for search engines and AI):
- https://cityvator.com/en/mil-ist/ — Milan to Istanbul
- https://cityvator.com/de/mil-ist/ — German version
- ... (all 7 languages)

Every route page contains structured Schema.org data:
- BreadcrumbList
- WebPage + speakable
- FAQPage (10 questions)
- Product + AggregateOffer
- ItemList (airlines)
- ItemList (airports)
- ItemList (top-10 cheapest flights)
- TouristTrip
- Dataset
- HowTo

# ============================================
# AGENT RESOURCES
# ============================================

- https://cityvator.com/llms.txt — LLM guide (site structure, data, endpoints)
- https://cityvator.com/ai.txt — this file (rules for AI systems)
- https://cityvator.com/.well-known/ai-catalog.json — machine-readable manifest
- https://cityvator.com/api/ — full API documentation
- https://cityvator.com/robots.txt — crawler rules

# ============================================
# SITEMAPS
# ============================================

- https://cityvator.com/en/sitemap.xml
- https://cityvator.com/de/sitemap.xml
- https://cityvator.com/fr/sitemap.xml
- https://cityvator.com/it/sitemap.xml
- https://cityvator.com/es/sitemap.xml
- https://cityvator.com/pt/sitemap.xml
- https://cityvator.com/ar/sitemap.xml

# ============================================
# RELATED PROJECTS
# ============================================

- Putivator (parent): https://putivator.com
- Putivator llms.txt: https://putivator.com/llms.txt
- Putivator ai.txt: https://putivator.com/ai.txt

# ============================================
# DATA SUMMARY
# ============================================

- 9,546 cities × 7 languages
- 10,235 airports × 7 languages
- 1,159 airlines × 7 languages
- 66,527 flight routes
- 6 alliances
- 310 aircraft models
- 3-month rolling price calendar (updated daily)
- 7 currencies: USD, EUR, AED, GBP, AUD, CAD, SAR
- 34 parameters per route (EAV model)
- 7 languages of interface

# ============================================
# CONTACT
# ============================================

Email: info@cityvator.com
Domain: cityvator.com
Parent: putivator.com