# Cityvator

> Cityvator is a flight search engine and open travel data platform covering 9,546 cities, 10,235 airports, 1,159 airlines and 66,527 flight routes worldwide. It is an AI-first service: all data is structured as an Entity-Attribute-Value (EAV) model with 34 well-defined parameters per route, designed for LLM agents, RAG systems and search engines.

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

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

## Main sections

- [Homepage (EN)](https://cityvator.com/en/): Search and compare flight prices worldwide
- [Homepage (DE)](https://cityvator.com/de/): German version
- [Homepage (FR)](https://cityvator.com/fr/): French version
- [Homepage (IT)](https://cityvator.com/it/): Italian version
- [Homepage (ES)](https://cityvator.com/es/): Spanish version
- [Homepage (PT)](https://cityvator.com/pt/): Portuguese version
- [Homepage (AR)](https://cityvator.com/ar/): Arabic version (RTL)

## Route pages

Every flight route has a dedicated page: /{lang}/{origin_iata}-{destination_iata}/

Example: https://cityvator.com/en/mil-ist/ — Milan to Istanbul

Each route page includes:
- Minimum, average and maximum prices over the next 3 months
- A 3-month price calendar (daily prices)
- All found flight variants (airline, time, transfers, agency, price)
- Airlines operating on the route with their minimum prices
- Agencies selling tickets on the route
- Airports of departure and arrival
- Flight statistics: distance, duration, time difference, cheapest day of week, cheapest month
- Other destinations from the same city and within the same country
- FAQ (10 questions)
- Schema.org: BreadcrumbList, WebPage, FAQPage, Product, ItemList

## Route parameters (EAV model)

Every route is described by 34 parameters across the following categories:

Prices: min_price, avg_price, max_price, min_price_direct, min_price_1stop
Geography: distance_km, flight_time_min, time_diff_hours
Flights: has_direct, airlines_count, departures_per_week, direct_share, airports_departure, airports_arrival
Analytics: popularity_score, cheapest_month, cheapest_weekday, price_trend, price_change_30d, flights_found
Agencies: agencies_count, cheapest_agency
Additional: seasonality, avg_duration_min, min_duration_min, max_duration_min, avg_transfers, direct_flights_count, eco_score
Arrays: agencies, airlines, direct_airlines_list, airports_departure_list, airports_arrival_list, months_with_flights

Full definitions are available at: https://cityvator.com/api/params

## Data

- 9,546 cities across 253 countries (7 languages each)
- 10,235 airports (7 languages each)
- 1,159 airlines with logos and low-cost flags
- 66,527 flight routes
- 6 alliances: Star Alliance, OneWorld, SkyTeam, Vanilla Alliance, U-FLY Alliance, Value Alliance
- 310 aircraft models
- 3-month rolling price calendar updated daily
- 7 currencies: USD, EUR, AED, GBP, AUD, CAD, SAR

## API for AI systems

IMPORTANT: The Cityvator API is available for AI systems and search engines ONLY.

Allowed user-agents:
- GPTBot, OAI-SearchBot, ChatGPT-User (OpenAI)
- ClaudeBot, Claude-Web, Claude-SearchBot (Anthropic)
- PerplexityBot (Perplexity)
- Googlebot, Google-Extended (Google and Gemini)
- Bingbot (Microsoft and Copilot)
- YandexBot (Yandex)
- DuckDuckBot
- CCBot (Common Crawl)
- Applebot, Applebot-Extended (Apple)
- cohere-ai
- YouBot

All other clients receive HTTP 403 Forbidden.

Rate limit: 1200 requests per minute per IP. Cached for 1 hour.

Scraping, parsing or cloning the database is prohibited.

### API endpoints

- [API reference](https://cityvator.com/api/): Full documentation
- [Parameter definitions](https://cityvator.com/api/params): All 34 parameters with types, units and descriptions
- [Routes list](https://cityvator.com/api/routes/): All 66,527 routes with pagination
- [Single route](https://cityvator.com/api/routes/mil-ist): Complete data for one route
- [Search](https://cityvator.com/api/search?from=MIL&max_price=150): Search routes by parameters
- [Compare](https://cityvator.com/api/compare/mil-ist-vs-mil-bcn): Compare 2–5 routes
- [Q&A for a route](https://cityvator.com/api/qa/route/mil-ist): Ready-made Q&A for RAG systems

### AI manifest

- [.well-known/ai-catalog.json](https://cityvator.com/.well-known/ai-catalog.json): Machine-readable manifest for AI agents

## Related projects

- [Putivator](https://putivator.com): Parent project — travel destinations and beaches described by parameters
- [Putivator llms.txt](https://putivator.com/llms.txt): Putivator LLM guide
- [Putivator ai.txt](https://putivator.com/ai.txt): Putivator AI rules

## License

Data is available under CC-BY-4.0 with attribution to cityvator.com.

Required attribution:
Data source: Cityvator (https://cityvator.com)

## Contact

info@cityvator.com