{ "specVersion": "1.0", "host": { "displayName": "Cityvator", "identifier": "cityvator.com", "url": "https://cityvator.com/", "parent": { "displayName": "Putivator", "identifier": "putivator.com", "url": "https://putivator.com/" } }, "description": "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. Every route is described by 34 parameters using an Entity-Attribute-Value model designed for AI agents and search engines.", "languages": ["en", "de", "fr", "it", "es", "pt", "ar"], "license": "CC-BY-4.0", "attribution": "Data source: Cityvator (https://cityvator.com)", "contact": "info@cityvator.com", "entries": [ { "identifier": "urn:air:cityvator.com:knowledge:llms-txt", "displayName": "Cityvator LLM Guide", "type": "text/plain", "url": "https://cityvator.com/llms.txt", "description": "Structured site description for LLMs: main sections, route pages, 34 parameters, API endpoints, data coverage, license. Covers 9,546 cities, 10,235 airports, 1,159 airlines and 66,527 routes.", "representativeQueries": [ "flight data API for AI", "cheap flights database for LLM", "routes and airlines structured dataset" ] }, { "identifier": "urn:air:cityvator.com:knowledge:ai-txt", "displayName": "Cityvator AI Rules", "type": "text/plain", "url": "https://cityvator.com/ai.txt", "description": "Usage rules for AI systems: license CC-BY-4.0, attribution, allowed user-agents, rate limits, API endpoints.", "representativeQueries": [ "AI usage rules for flight data", "allowed AI crawlers for flights", "flight data license for AI" ] }, { "identifier": "urn:air:cityvator.com:api:index", "displayName": "Cityvator API Documentation", "type": "text/html", "url": "https://cityvator.com/api/", "description": "Full reference for the Cityvator API: 7 endpoints, parameters, examples, rate limits, license. Access restricted to AI systems and search engines.", "representativeQueries": [ "Cityvator API documentation", "flight API endpoints list", "how to query routes API" ] }, { "identifier": "urn:air:cityvator.com:api:params", "displayName": "Cityvator Parameters API", "type": "application/json", "url": "https://cityvator.com/api/params", "description": "Definitions of all 34 route parameters with types (number, string, array, boolean, enum), units, formats and descriptions. Self-describing metadata for AI agents.", "representativeQueries": [ "flight route parameter definitions", "what data types are available for routes", "list of 34 flight parameters" ] }, { "identifier": "urn:air:cityvator.com:api:routes", "displayName": "Cityvator Routes API (list)", "type": "application/json", "url": "https://cityvator.com/api/routes/", "description": "JSON list of all 66,527 flight routes with pagination (?limit=100&offset=0, max limit 500). Fields: origin, destination, min_price, distance, airlines count, has_direct.", "representativeQueries": [ "list of all flight routes", "cheap routes from Milan", "flight routes database JSON" ] }, { "identifier": "urn:air:cityvator.com:api:route", "displayName": "Cityvator Route API (single)", "type": "application/json", "url": "https://cityvator.com/api/routes/mil-ist", "description": "Complete data for one route with all 34 parameters: prices, distance, duration, airlines, airports, seasonality, cheapest month, cheapest weekday. Includes arrays of airlines, agencies, airports.", "representativeQueries": [ "Milan Istanbul flight data", "flight price and duration for a route", "airlines operating a route" ] }, { "identifier": "urn:air:cityvator.com:api:search", "displayName": "Cityvator Search API", "type": "application/json", "url": "https://cityvator.com/api/search", "description": "Search routes by parameters: from, to, max_price, min_price, has_direct, max_transfers, min_popularity, sort, limit, offset. Example: ?from=MIL&max_price=150&has_direct=true", "representativeQueries": [ "cheap direct flights from Milan", "where can I fly for under 150 USD", "find routes with direct flights" ] }, { "identifier": "urn:air:cityvator.com:api:compare", "displayName": "Cityvator Compare API", "type": "application/json", "url": "https://cityvator.com/api/compare/mil-ist-vs-mil-bcn", "description": "Compare 2 to 5 routes by all 34 parameters with a winner per parameter and overall scores.", "representativeQueries": [ "Milan Istanbul vs Milan Barcelona", "which route is cheaper", "compare flight routes" ] }, { "identifier": "urn:air:cityvator.com:api:qa-route", "displayName": "Cityvator Route Q&A API", "type": "application/json", "url": "https://cityvator.com/api/qa/route/mil-ist", "description": "Ready-made Q&A for a route: generated from the 34 parameters. Topics: price, duration, airlines, airports, direct, seasonality, booking. Ideal for RAG systems.", "representativeQueries": [ "how much is a flight from Milan to Istanbul", "how long is the flight from Milan to Istanbul", "are there direct flights to Istanbul" ] }, { "identifier": "urn:air:cityvator.com:dataset:routes", "displayName": "Cityvator Routes Dataset", "type": "application/ld+json", "url": "https://cityvator.com/en/", "description": "HTML pages with JSON-LD markup: WebPage, BreadcrumbList, FAQPage, Product, ItemList (airlines, airports, cheapest flights), TouristTrip, Dataset, HowTo. 7 languages.", "representativeQueries": [ "routes catalog with structured data", "flight JSON-LD dataset", "flight destinations marked up for search" ] }, { "identifier": "urn:air:cityvator.com:dataset:cities", "displayName": "Cityvator Cities Dataset", "type": "application/ld+json", "url": "https://cityvator.com/en/", "description": "9,546 cities across 253 countries with names in 7 languages, IATA codes, coordinates and hub flags.", "representativeQueries": [ "list of cities with airports", "IATA codes of cities", "hubs worldwide" ] }, { "identifier": "urn:air:cityvator.com:dataset:airlines", "displayName": "Cityvator Airlines Dataset", "type": "application/ld+json", "url": "https://cityvator.com/en/", "description": "1,159 airlines with names in 7 languages, IATA codes, logos, low-cost flags and route counts.", "representativeQueries": [ "list of airlines with logos", "low-cost airlines worldwide", "airlines operating routes" ] }, { "identifier": "urn:air:cityvator.com:dataset:airports", "displayName": "Cityvator Airports Dataset", "type": "application/ld+json", "url": "https://cityvator.com/en/", "description": "10,235 airports with names in 7 languages, IATA codes, city linkage, coordinates, time zones and IATA type.", "representativeQueries": [ "list of airports with IATA codes", "airports by city", "flightable airports only" ] }, { "identifier": "urn:air:cityvator.com:sitemap:index", "displayName": "Cityvator Sitemaps", "type": "application/xml", "url": "https://cityvator.com/en/sitemap.xml", "description": "Sitemap index in 7 languages: homepages, popular routes, route pages.", "representativeQueries": [ "Cityvator sitemap", "list of all route pages", "sitemap for flights" ] }, { "identifier": "urn:air:cityvator.com:robots", "displayName": "Cityvator robots.txt", "type": "text/plain", "url": "https://cityvator.com/robots.txt", "description": "Crawler rules: AI bots (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, CCBot, Applebot, etc.) explicitly allowed with Crawl-delay; SEO crawlers and Meta AI blocked; admin, cache and API disallowed.", "representativeQueries": [ "Cityvator robots.txt rules", "allowed AI crawlers", "crawl delay policy" ] }, { "identifier": "urn:air:putivator.com:knowledge:llms-txt", "displayName": "Putivator LLM Guide (parent project)", "type": "text/plain", "url": "https://putivator.com/llms.txt", "description": "Parent project: travel destinations and beaches described by 73 and 60 parameters. Same EAV approach and AI-first principles.", "representativeQueries": [ "Putivator LLM guide", "travel destinations dataset", "beaches data for AI" ] } ] }