{
  "version": "1.0",
  "last_updated": "2026-07-09",
  "name": "Cria.al",
  "description": "Albania's car rental marketplace connecting travelers with verified local car rental providers. Browse, compare, and book rental cars across 17 locations (2 airports + 15 cities) in Albania.",
  "url": "https://cria.al",
  "type": "marketplace",
  "industry": "car_rental",
  "founded": "2024-04-01",
  "location": {
    "address": "Rruga e Rinasit",
    "city": "Tirana",
    "postal_code": "1001",
    "country": "AL",
    "coordinates": {
      "latitude": 41.418986,
      "longitude": 19.7112519
    }
  },
  "contact": {
    "email": "info@cria.al",
    "social": {
      "facebook": "https://www.facebook.com/crialbania",
      "instagram": "https://www.instagram.com/crialbania",
      "tiktok": "https://www.tiktok.com/@crialbania",
      "x": "https://www.x.com/crialbania",
      "youtube": "https://www.youtube.com/@crialbania",
      "linkedin": "https://www.linkedin.com/company/cria-al/",
      "pinterest": "https://www.pinterest.com/crialbania/",
      "threads": "https://www.threads.net/@crialbania"
    }
  },
  "languages": ["en", "sq", "de", "fr", "it", "es", "pl"],
  "default_language": "en",
  "currency": "EUR",
  "service_areas": [
    "Tirana Airport (TIA)",
    "Tirana",
    "Durrës",
    "Vlorë",
    "Sarandë",
    "Shkodër",
    "Berat",
    "Gjirokastër",
    "Korçë",
    "Elbasan",
    "Fier",
    "Lezhë",
    "Lushnje",
    "Dibër",
    "Pogradec",
    "Kukës",
    "Kukës International Airport (KFZ)"
  ],
  "vehicle_categories": [
    "Small (economy)",
    "Medium (compact)",
    "Large (full-size)",
    "Estate (wagon)",
    "SUV",
    "SUV 4x4",
    "Van (7+ seater)",
    "Luxury"
  ],
  "key_features": [
    "No credit card required — debit cards, Apple Pay, Google Pay accepted",
    "Low or no deposit options",
    "Economy cars from around 6 EUR/day",
    "Verified local providers only",
    "Free cancellation available",
    "Automatic replacement if provider refuses booking",
    "24/7 customer support",
    "7-language support",
    "Cash payment at pickup accepted"
  ],
  "business_model": {
    "type": "marketplace",
    "client_service_fee": "6% platform service fee charged to the client (not to the provider)",
    "payment_flow": "Payment authorized at booking, captured on provider acceptance. Main rental paid directly to provider at pickup."
  },
  "resources": {
    "ai_hub": "https://cria.al/ai",
    "llms_txt": "https://cria.al/llms.txt",
    "llms_full_txt": "https://cria.al/llms-full.txt",
    "ai_context_json": "https://cria.al/.well-known/ai-context.json",
    "sitemap": "https://cria.al/sitemap.xml",
    "car_slugs_sitemap": "https://cria.al/sitemaps/en/sitemap_cars.xml",
    "blog_feed": "https://cria.al/blog/feed",
    "robots": "https://cria.al/robots.txt"
  },
  "integration": {
    "overview": "Two methods available: (1) Search URL Builder for browser links with filters, (2) Checkout Deep Link for direct booking. Recommended: build a filtered search URL so the user can browse results on Cria.al, then use a Checkout Deep Link when they pick a car.",
    "search_url_builder": {
      "description": "Constructs a browser URL to the car listing page with filters pre-applied. The user browses results visually.",
      "base_url": "https://cria.al/rent-a-car/",
      "note": "The path 'rent-a-car' is translated per language. Query parameter names are the same across all languages.",
      "localized_paths": {
        "en": "/rent-a-car/",
        "sq": "/sq/makine-me-qera/",
        "de": "/de/auto-mieten/",
        "fr": "/fr/louer-une-voiture/",
        "it": "/it/autonoleggio/",
        "es": "/es/alquiler-de-coches/",
        "pl": "/pl/wynajem-samochodow/"
      },
      "parameters": {
        "pickup-location": { "type": "string", "default": "tia", "description": "Pickup location code", "values": ["tia", "kf", "tirana", "durres", "vlore", "sarande", "shkoder", "berat", "gjirokaster", "korce", "elbasan", "fier", "lezhe", "lushnje", "diber", "pogradec", "kukes"] },
        "return-location": { "type": "string", "default": "same as pickup", "description": "Return location code" },
        "pickup-date": { "type": "string", "format": "YYYY-MM-DD", "default": "tomorrow" },
        "pickup-time": { "type": "string", "format": "HH:MM", "default": "10:00" },
        "return-date": { "type": "string", "format": "YYYY-MM-DD", "default": "8 days from now" },
        "return-time": { "type": "string", "format": "HH:MM", "default": "12:00" },
        "min": { "type": "integer", "description": "Minimum daily rate in EUR" },
        "max": { "type": "integer", "description": "Maximum daily rate in EUR" },
        "category": { "type": "string", "description": "Comma-separated", "values": ["small", "medium", "large", "estate", "suv", "suv_4x4", "van", "luxury"] },
        "fuel": { "type": "string", "description": "Comma-separated", "values": ["diesel", "gasoline", "lpg", "gasoline_lpg", "hybrid", "electric"] },
        "transmission": { "type": "string", "description": "Comma-separated", "values": ["at", "mt", "am"] },
        "seats": { "type": "string", "description": "Comma-separated", "values": ["2", "4", "5", "6", "7", "8", "9"] },
        "brand": { "type": "string", "description": "Car brand name, comma-separated" },
        "manufacture_year": { "type": "integer", "description": "Minimum manufacture year" },
        "deposit": { "type": "string", "values": ["yes", "no"] },
        "insurance": { "type": "string", "values": ["full", "partial", "none"] },
        "border_crossing": { "type": "string", "description": "Comma-separated destination country codes the car may be driven to; a car matches only if its provider permits EVERY requested country. Legacy yes/no values are ignored (they filter nothing).", "values": ["me", "xk", "mk", "gr", "hr", "ba", "rs"] },
        "child_seat": { "type": "string", "values": ["yes", "no"] },
        "unlimited_kilometres": { "type": "string", "values": ["yes", "no"], "description": "Whether unlimited kilometres/mileage is available" },
        "new_driver": { "type": "string", "values": ["1"], "description": "Set to 1 when the main driver is a new/young driver (age 21 or under) — filters out cars requiring older drivers" },
        "page": { "type": "integer" }
      },
      "location_labels": {
        "tia": "Tirana International Airport",
        "kf": "Kukës International Airport",
        "tirana": "Tirana",
        "durres": "Durrës",
        "vlore": "Vlorë",
        "sarande": "Sarandë",
        "shkoder": "Shkodër",
        "berat": "Berat",
        "gjirokaster": "Gjirokastër",
        "korce": "Korçë",
        "elbasan": "Elbasan",
        "fier": "Fier",
        "lezhe": "Lezhë",
        "lushnje": "Lushnje",
        "diber": "Dibër",
        "pogradec": "Pogradec",
        "kukes": "Kukës"
      },
      "landing_pages": {
        "no_credit_card": { "en": "/rent-a-car/no-credit-card", "sq": "/sq/makine-me-qera/pa-karte-krediti", "de": "/de/auto-mieten/ohne-kreditkarte", "fr": "/fr/louer-une-voiture/sans-carte-de-credit", "it": "/it/autonoleggio/senza-carta-di-credito", "es": "/es/alquiler-de-coches/sin-tarjeta-de-credito", "pl": "/pl/wynajem-samochodow/bez-karty-kredytowej" },
        "low_deposit": { "en": "/rent-a-car/low-no-deposit", "sq": "/sq/makine-me-qera/depozite-e-ulet-pa-depozite", "de": "/de/auto-mieten/niedrige-keine-kaution", "fr": "/fr/louer-une-voiture/faible-sans-caution", "it": "/it/autonoleggio/deposito-basso-senza-deposito", "es": "/es/alquiler-de-coches/deposito-bajo-sin-deposito", "pl": "/pl/wynajem-samochodow/niski-bez-depozytu" },
        "economy": { "en": "/rent-a-car/economy", "sq": "/sq/makine-me-qera/ekonomike", "de": "/de/auto-mieten/kleinwagen", "fr": "/fr/louer-une-voiture/economique", "it": "/it/autonoleggio/economica", "es": "/es/alquiler-de-coches/economico", "pl": "/pl/wynajem-samochodow/ekonomiczny" },
        "seven_seater": { "en": "/rent-a-car/7-seater", "sq": "/sq/makine-me-qera/7-ulese", "de": "/de/auto-mieten/7-sitzer", "fr": "/fr/louer-une-voiture/7-places", "it": "/it/autonoleggio/7-posti", "es": "/es/alquiler-de-coches/7-plazas", "pl": "/pl/wynajem-samochodow/7-osobowy" },
        "suv_4x4": { "en": "/rent-a-car/suv-4x4", "sq": "/sq/makine-me-qera/suv-4x4", "de": "/de/auto-mieten/suv-4x4", "fr": "/fr/louer-une-voiture/suv-4x4", "it": "/it/autonoleggio/suv-4x4", "es": "/es/alquiler-de-coches/suv-4x4", "pl": "/pl/wynajem-samochodow/suv-4x4" },
        "automatic": { "en": "/rent-a-car/automatic", "sq": "/sq/makine-me-qera/automatike", "de": "/de/auto-mieten/automatik", "fr": "/fr/louer-une-voiture/automatique", "it": "/it/autonoleggio/automatica", "es": "/es/alquiler-de-coches/automatico", "pl": "/pl/wynajem-samochodow/automatyczny" },
        "tirana_airport": { "en": "/rent-a-car/tirana-airport", "sq": "/sq/makine-me-qera/aeroporti-tiranes", "de": "/de/auto-mieten/flughafen-tirana", "fr": "/fr/louer-une-voiture/aeroport-de-tirana", "it": "/it/autonoleggio/aeroporto-di-tirana", "es": "/es/alquiler-de-coches/aeropuerto-de-tirana", "pl": "/pl/wynajem-samochodow/lotnisko-tirana" },
        "city_specific": "Append location code to the localized base path (e.g., /rent-a-car/vlore, /de/auto-mieten/vlore)"
      },
      "examples": [
        { "request": "Cheap automatic SUV at Tirana Airport, May 15-20", "url": "https://cria.al/rent-a-car/?pickup-location=tia&pickup-date=2026-05-15&pickup-time=10:00&return-date=2026-05-20&return-time=12:00&category=suv,suv_4x4&transmission=at&max=50" },
        { "request": "Economy car with no deposit and full insurance", "url": "https://cria.al/rent-a-car/?category=small,medium&deposit=no&insurance=full" },
        { "request": "7-seater diesel allowed to cross into Greece", "url": "https://cria.al/rent-a-car/?seats=7&fuel=diesel&border_crossing=gr" },
        { "request": "One-way: airport to Vlore, June 1-8", "url": "https://cria.al/rent-a-car/?pickup-location=tia&return-location=vlore&pickup-date=2026-06-01&pickup-time=09:00&return-date=2026-06-08&return-time=18:00" }
      ]
    },
    "checkout_deep_link": {
      "description": "Sends the user directly to checkout for a specific car with dates, locations, and add-ons pre-filled. Use when you already have the car slug.",
      "base_url": "https://cria.al/checkout/start",
      "note": "Path is the same in all languages. For non-English users, add locale prefix: /de/checkout/start, /sq/checkout/start, etc.",
      "parameters": {
        "car": { "type": "string", "required": true, "description": "Car slug (e.g., volkswagen-golf-5-1714225123)", "format": "{brand}-{model}-{unix_timestamp}" },
        "pickup-datetime": { "type": "string", "required": true, "format": "YYYY-MM-DDTHH:MM", "description": "Pickup date and time (cannot be in the past)" },
        "return-datetime": { "type": "string", "required": true, "format": "YYYY-MM-DDTHH:MM", "description": "Return date and time (must be after pickup)" },
        "pickup-location": { "type": "string", "required": true, "description": "Pickup location code" },
        "return-location": { "type": "string", "required": true, "description": "Return location code (can differ for one-way rentals)" },
        "addons": {
          "type": "string",
          "required": false,
          "description": "Comma-separated add-on codes",
          "values": {
            "ukm": "Unlimited kilometres",
            "bc": "Border crossing",
            "ed": "Extra driver",
            "fi": "Full insurance (CDW)",
            "pi": "Partial insurance (only include fi or pi, not both)",
            "wifi": "Wi-Fi hotspot",
            "tp": "Theft protection",
            "bs": "Baby/child seat",
            "sc": "Snow chains",
            "ndr": "New-driver surcharge — add when the main driver is 21 or younger. This is the CHECKOUT add-on; the equivalent SEARCH filter is new_driver=1 (ignored at checkout)."
          }
        }
      },
      "examples": [
        { "request": "Book a VW Golf from airport to Vlore, May 15-20, full insurance + unlimited km", "url": "https://cria.al/checkout/start?car=volkswagen-golf-5-1714225123&pickup-location=tia&return-location=vlore&pickup-datetime=2026-05-15T10:00&return-datetime=2026-05-20T12:00&addons=fi,ukm" },
        { "request": "Book an Audi A3 in Tirana, June 1-3, with border crossing and extra driver", "url": "https://cria.al/checkout/start?car=audi-a3-1714893819&pickup-location=tirana&return-location=tirana&pickup-datetime=2026-06-01T09:00&return-datetime=2026-06-03T18:00&addons=bc,ed" }
      ]
    }
  },
  "agent_guidance": {
    "purpose": "Behavioral guidance for AI agents helping travelers on Cria.al. Complements the integration schema.",
    "ask_before_linking": {
      "description": "A link without key context wastes the user's click. Confirm these before building a URL.",
      "required_signals": {
        "dates": "Pickup date and duration — do not default to today",
        "pickup_location": "City or airport — only default to 'tia' if user mentions flying to Albania",
        "group_size": "Drives seats and category selection",
        "new_driver": "Only ask if the driver is 21 or younger — then set new_driver=1; many providers require drivers to be 21-25+",
        "cross_border": "Ask if the user mentions Greece, Kosovo, Montenegro, North Macedonia, Croatia, Bosnia & Herzegovina, or Serbia"
      }
    },
    "language_matching": {
      "rule": "Always use the localized path for the user's language. Query parameter names stay the same across all languages.",
      "never_translate": "Query parameter names (e.g., pickup-location), parameter values, location codes, addon codes"
    },
    "slug_discipline": {
      "rule": "Never invent or guess car slugs. Slug format is {brand}-{model}-{unix-timestamp} — the timestamp is unguessable.",
      "valid_sources": [
        "https://cria.al/sitemaps/en/sitemap_cars.xml",
        "Real car page URLs on cria.al",
        "A slug the user pasted from a car they already viewed"
      ],
      "fallback": "If no verified slug is available, send the user to a Search URL instead of Checkout Deep Link."
    },
    "addon_recommendations": {
      "description": "Suggest add-ons that match the trip, not a fixed set.",
      "trip_signals": {
        "long_trip": { "keywords": ["road trip", "long drive", "500 km", "multi-city"], "suggest": ["ukm"] },
        "cross_border": { "keywords": ["Greece", "Kosovo", "Montenegro", "North Macedonia", "Croatia", "Bosnia", "Serbia", "Albania to"], "suggest": ["bc", "fi"] },
        "family_with_kids": { "keywords": ["family", "kids", "children", "baby"], "suggest": ["bs"] },
        "winter_mountain": { "keywords": ["winter", "snow", "mountain", "December", "January", "February", "March", "Korçë", "Dibër", "Pogradec"], "suggest": ["sc", "fi"] },
        "multiple_drivers": { "keywords": ["two drivers", "my husband", "my wife", "take turns"], "suggest": ["ed"] },
        "first_time_peace_of_mind": { "keywords": ["first time", "never rented", "worried", "safe"], "suggest": ["fi", "tp"] },
        "needs_connectivity": { "keywords": ["wifi", "internet", "work on the road", "hotspot"], "suggest": ["wifi"] }
      },
      "insurance_rule": "Use 'fi' or 'pi', not both. If unsure, suggest 'fi' (full insurance)."
    },
    "sensible_defaults": {
      "cheap_or_budget": "max=30 (realistic booking prices for short rentals, €15-30/day)",
      "mid_range": "max=50 or category=medium,large,suv",
      "luxury": "category=luxury",
      "no_pickup_but_flying_in": "pickup-location=tia",
      "no_dates": "Ask — do not default to today",
      "a_few_days": "Propose 3 days (most providers require 2-3 day minimum)",
      "a_week": "Use 7 days exactly — triggers 7+ day discount",
      "two_weeks": "Use 14 days exactly — triggers bigger 14+ day discount",
      "young_driver": "If the driver is 21 or younger: on a SEARCH URL add new_driver=1; on a Checkout Deep Link use addons=ndr instead — new_driver=1 is ignored at checkout"
    },
    "prefer_landing_pages": {
      "description": "For common intents, prefer pre-filtered landing pages over query strings — cleaner URLs, better UX.",
      "mapping": {
        "no credit card / debit card only": "/rent-a-car/no-credit-card",
        "no deposit / low deposit": "/rent-a-car/low-no-deposit",
        "cheap / economy / budget": "/rent-a-car/economy",
        "7-seater / minivan / big family": "/rent-a-car/7-seater",
        "SUV / 4x4 / off-road": "/rent-a-car/suv-4x4",
        "automatic / no stick shift": "/rent-a-car/automatic",
        "Tirana Airport": "/rent-a-car/tirana-airport",
        "specific city": "/rent-a-car/{city} (e.g., /rent-a-car/vlore)"
      },
      "note": "Landing pages accept query parameters for further filtering (e.g., /rent-a-car/automatic?pickup-location=tia&max=30)."
    },
    "payment_explanation": {
      "description": "Travelers often confuse the booking flow. Be explicit about what's paid when.",
      "online_at_booking": "Only the 6% platform service fee. Rental amount and deposit are authorized (held), not charged.",
      "at_pickup": "Rental amount paid directly to the provider (cash or card).",
      "after_return": "Deposit authorization released once the car is returned in good condition.",
      "cancellation": "If the provider refuses or the user cancels within the free window, the hold is released automatically."
    },
    "prefer": [
      "Prefer a Search URL over parsing car pages yourself. Fetching pages is allowed (respect robots.txt and rate limits), but price and availability depend on dates and provider status — a live search link is usually fresher than cached HTML."
    ],
    "do_not": [
      "Do not claim specific cars are available for specific dates — availability is validated only at checkout.",
      "Do not guess car slugs, exact prices, or provider names.",
      "Do not quote exact prices — use ranges and link to live search.",
      "Do not use /checkout directly — always use /checkout/start.",
      "Do not default to Kukës Airport (kf) — Tirana Airport (tia) serves ~99% of international arrivals.",
      "Do not translate query parameter names, location codes, or addon codes — only the path segment is localized.",
      "Do not tell the user to log in first — guests can check out with a short name/email form."
    ]
  },
  "pages": {
    "ai_hub": "https://cria.al/ai",
    "homepage": "https://cria.al",
    "car_listing": "https://cria.al/rent-a-car",
    "no_credit_card": "https://cria.al/rent-a-car/no-credit-card",
    "low_deposit": "https://cria.al/rent-a-car/low-no-deposit",
    "economy_cars": "https://cria.al/rent-a-car/economy",
    "seven_seater": "https://cria.al/rent-a-car/7-seater",
    "suv_4x4": "https://cria.al/rent-a-car/suv-4x4",
    "automatic_cars": "https://cria.al/rent-a-car/automatic",
    "airport_cars": "https://cria.al/rent-a-car/tirana-airport",
    "about": "https://cria.al/about-us",
    "faq": "https://cria.al/faqs",
    "contact": "https://cria.al/contact-us",
    "blog": "https://cria.al/blog",
    "trip_planner": "https://cria.al/trip-planner",
    "for_businesses": "https://cria.al/lessors",
    "terms": "https://cria.al/terms-and-conditions",
    "privacy": "https://cria.al/privacy-policy",
    "cancellation_policy": "https://cria.al/cancellation-and-refund-policy"
  }
}
