{
  "version": "1.1",
  "last_updated": "2026-07-15",
  "name": "Cria.al",
  "description": "Car-rental marketplace connecting travelers with verified, active local providers across 17 operation areas in Albania.",
  "url": "https://cria.al",
  "type": "marketplace",
  "industry": "car_rental",
  "languages": ["en", "sq", "de", "fr", "it", "es", "pl"],
  "default_language": "en",
  "currency": "EUR",
  "contact": {
    "page": "https://cria.al/contact-us",
    "email": "info@cria.al"
  },
  "organization": {
    "founding_date": "2024-04-01",
    "location": {
      "street_address": "Rruga e Rinasit",
      "city": "Tirana",
      "region": "Tirana",
      "postal_code": "1001",
      "country": "AL",
      "coordinates": {"latitude": 41.418986, "longitude": 19.7112519}
    },
    "social": [
      "https://www.facebook.com/crialbania",
      "https://www.instagram.com/crialbania",
      "https://www.tiktok.com/@crialbania",
      "https://www.x.com/crialbania",
      "https://www.youtube.com/@crialbania",
      "https://www.linkedin.com/company/cria-al/",
      "https://www.pinterest.com/crialbania/",
      "https://www.threads.net/@crialbania"
    ]
  },
  "service_areas": {
    "count": 17,
    "codes": {
      "tia": "Tirana International Airport",
      "kf": "Kukës International Airport",
      "tirana": "Tirana",
      "durres": "Durrës",
      "vlore": "Vlorë",
      "sarande": "Sarandë",
      "fier": "Fier",
      "lushnje": "Lushnje",
      "shkoder": "Shkodër",
      "lezhe": "Lezhë",
      "berat": "Berat",
      "diber": "Dibër",
      "elbasan": "Elbasan",
      "gjirokaster": "Gjirokastër",
      "korce": "Korçë",
      "pogradec": "Pogradec",
      "kukes": "Kukës"
    }
  },
  "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_index": "https://cria.al/sitemap.xml",
    "english_car_sitemap": "https://cria.al/sitemaps/en/sitemap_cars.xml",
    "blog_feed": "https://cria.al/blog/feed",
    "robots": "https://cria.al/robots.txt"
  },
  "agent_contract": {
    "purpose": "Navigate the traveler to a live Cria.al car list, verified car profile, or supported checkout handoff. Do not replace those pages with an agent-generated quote.",
    "workflow": {
      "no_selected_car": "Send the traveler to a filtered car list.",
      "specific_car": "Send the traveler to the verified live car profile.",
      "ready_to_book": "When a verified car, both locations, and exact future pickup and return datetimes are known, send the traveler to /checkout/start."
    },
    "price_rule": "Never calculate, estimate, mark up, or reconstruct a price or fee. Only repeat a value just read from a live Cria.al page, link to its source, and treat checkout as final.",
    "availability_rule": "Never promise availability. The live booking flow validates it.",
    "options_rule": "Never choose, price, or preselect insurance or add-ons. Availability, mandatory state, quantity, daily or total charge type, and price vary by car and provider.",
    "fallback": "If a car slug or required checkout value is missing or unverified, use the filtered list or verified car profile instead of constructing checkout."
  },
  "integration": {
    "search_url_builder": {
      "purpose": "Build a browser URL for live inventory with supported filters. Search results are not a guaranteed reservation or final quote.",
      "base_url": "https://cria.al/rent-a-car/",
      "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/"
      },
      "parameter_rule": "Parameter names and values are not translated. Multi-value filters use comma-separated values.",
      "parameters": {
        "pickup-location": {
          "type": "string",
          "values": ["tia", "kf", "tirana", "durres", "vlore", "sarande", "fier", "lushnje", "shkoder", "lezhe", "berat", "diber", "elbasan", "gjirokaster", "korce", "pogradec", "kukes"]
        },
        "return-location": {
          "type": "string",
          "description": "Uses the same location codes as pickup-location."
        },
        "pickup-date": {"type": "string", "format": "YYYY-MM-DD"},
        "pickup-time": {"type": "string", "format": "HH:MM"},
        "return-date": {"type": "string", "format": "YYYY-MM-DD"},
        "return-time": {"type": "string", "format": "HH:MM"},
        "min": {"type": "number", "unit": "EUR", "description": "Minimum displayed daily rate, not trip total."},
        "max": {"type": "number", "unit": "EUR", "description": "Maximum displayed daily rate, not trip total."},
        "brand": {"type": "string", "multiple": true, "description": "Use live brand names."},
        "category": {"type": "string", "multiple": true, "values": ["small", "medium", "large", "estate", "suv", "suv_4x4", "van", "luxury"]},
        "fuel": {"type": "string", "multiple": true, "values": ["diesel", "gasoline", "lpg", "gasoline_lpg", "hybrid", "electric"]},
        "transmission": {"type": "string", "multiple": true, "values": ["at", "mt", "am"]},
        "seats": {"type": "string", "multiple": true, "values": ["2", "4", "5", "6", "7", "8", "9"]},
        "manufacture_year": {"type": "integer", "description": "Minimum manufacture year."},
        "deposit": {"type": "string", "values": ["yes", "no"], "description": "Whether the car has a positive deposit amount."},
        "insurance": {"type": "string", "values": ["full", "partial", "none"], "description": "Capability filter only; does not select insurance."},
        "border_crossing": {"type": "string", "multiple": true, "values": ["me", "xk", "mk", "gr", "hr", "ba", "rs"], "value_labels": {"me": "Montenegro", "xk": "Kosovo", "mk": "North Macedonia", "gr": "Greece", "hr": "Croatia", "ba": "Bosnia and Herzegovina", "rs": "Serbia"}, "description": "Car must permit every requested country. Capability filter only."},
        "child_seat": {"type": "string", "values": ["yes", "no"], "description": "Capability filter only."},
        "unlimited_kilometres": {"type": "string", "values": ["yes", "no"], "description": "Capability filter only."},
        "new_driver": {"type": "string", "values": ["1"], "description": "Screens provider minimum-age rules against the site's reference age of 21; does not prove driver eligibility."}
      },
      "ui_defaults_warning": "The public UI may supply default dates, times, or location when omitted. Agents must ask for missing travel details rather than treating UI defaults as user instructions.",
      "landing_pages": {
        "no_credit_card": "/rent-a-car/no-credit-card",
        "low_or_no_deposit": "/rent-a-car/low-no-deposit",
        "economy": "/rent-a-car/economy",
        "seven_seater": "/rent-a-car/7-seater",
        "suv_4x4": "/rent-a-car/suv-4x4",
        "automatic": "/rent-a-car/automatic",
        "tirana_airport": "/rent-a-car/tirana-airport",
        "city_template": "/rent-a-car/{location_code}"
      },
      "intent_rule": "No credit card and no deposit are different intents. Use the corresponding dedicated landing page; do not substitute deposit=no for a no-credit-card request.",
      "examples_are_templates": true,
      "examples": [
        {
          "request": "Automatic SUV at confirmed Tirana Airport dates and times",
          "url_template": "https://cria.al/rent-a-car/?pickup-location=tia&pickup-date={future_pickup_date}&pickup-time={pickup_time}&return-date={future_return_date}&return-time={return_time}&category=suv,suv_4x4&transmission=at"
        },
        {
          "request": "One-way search from Tirana Airport to Vlore",
          "url_template": "https://cria.al/rent-a-car/?pickup-location=tia&return-location=vlore&pickup-date={future_pickup_date}&pickup-time={pickup_time}&return-date={future_return_date}&return-time={return_time}"
        }
      ]
    },
    "car_profile": {
      "purpose": "Review one real car's current details, policies, provider service areas and payment methods, displayed rates, deposit, insurance and extra-service capabilities, and availability form.",
      "url_template": "https://cria.al/rent-a-car/{verified_car_slug}",
      "slug_rule": "Treat the slug as opaque. Use only a live list link, real Cria.al car URL, user-provided Cria.al car URL, or live car sitemap. Never construct or modify it.",
      "price_rule": "Do not calculate a trip total from profile values."
    },
    "checkout_handoff": {
      "purpose": "Send the traveler into the supported live booking flow after every required value is verified. Checkout validates the request and shows the authoritative itemized result.",
      "base_url": "https://cria.al/checkout/start",
      "localized_paths": {
        "en": "/checkout/start",
        "sq": "/sq/checkout/start",
        "de": "/de/checkout/start",
        "fr": "/fr/checkout/start",
        "it": "/it/checkout/start",
        "es": "/es/checkout/start",
        "pl": "/pl/checkout/start"
      },
      "parameters": {
        "car": {"type": "string", "required": true, "description": "Opaque verified car slug."},
        "pickup-location": {"type": "string", "required": true, "description": "Confirmed code served by the selected provider."},
        "return-location": {"type": "string", "required": true, "description": "Confirmed code served by the selected provider."},
        "pickup-datetime": {"type": "string", "required": true, "format": "YYYY-MM-DDTHH:MM", "description": "Future pickup date and time."},
        "return-datetime": {"type": "string", "required": true, "format": "YYYY-MM-DDTHH:MM", "description": "Return date and time later than pickup."}
      },
      "agent_generated_options": "Do not add an addons parameter. The application reserves it for its own stateful flow; agents must not synthesize or preselect it.",
      "guest_rule": "Guests can continue through a short identity step. Do not require login before using the handoff.",
      "direct_checkout_rule": "Never link directly to /checkout; use /checkout/start.",
      "examples_are_templates": true,
      "examples": [
        {
          "request": "Open the supported booking handoff for a verified car",
          "url_template": "https://cria.al/checkout/start?car={verified_car_slug}&pickup-location={confirmed_pickup_code}&return-location={confirmed_return_code}&pickup-datetime={future_pickup_datetime}&return-datetime={future_return_datetime}"
        }
      ]
    }
  },
  "authoritative_pages": {
    "car_list": "https://cria.al/rent-a-car",
    "car_profile_template": "https://cria.al/rent-a-car/{verified_car_slug}",
    "booking_guide": "https://cria.al/how-to-book-a-car",
    "faq": "https://cria.al/faqs",
    "cancellation_policy": "https://cria.al/cancellation-and-refund-policy",
    "terms": "https://cria.al/terms-and-conditions",
    "privacy": "https://cria.al/privacy-policy",
    "contact": "https://cria.al/contact-us",
    "trip_planner": "https://cria.al/trip-planner",
    "rental_businesses": "https://cria.al/lessors"
  }
}
