{
  "version": "1.0",
  "last_updated": "2026-04-03",
  "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 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",
    "commission": "5% service fee charged to client, not to provider",
    "payment_flow": "Payment authorized at booking, captured on provider acceptance. Main rental paid directly to provider at pickup."
  },
  "resources": {
    "car_inventory_api": "https://cria.al/api/ai/cars",
    "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": "Three methods available: (1) Car Inventory API for structured JSON data, (2) Search URL Builder for browser links with filters, (3) Checkout Deep Link for direct booking. Recommended: use the Inventory API to find cars, then use checkout_url from the response.",
    "car_inventory_api": {
      "description": "Returns live car inventory as JSON. Primary integration point for AI agents.",
      "endpoint": "GET https://cria.al/api/ai/cars",
      "rate_limit": "30 requests per minute per IP",
      "authentication": "None required",
      "parameters": {
        "pickup-date": { "type": "string", "format": "YYYY-MM-DD", "description": "Pickup date. When provided with all date/time params, only available cars are returned." },
        "pickup-time": { "type": "string", "format": "HH:MM", "description": "Pickup time (24h). Required with pickup-date." },
        "return-date": { "type": "string", "format": "YYYY-MM-DD", "description": "Return date. Required with pickup-date." },
        "return-time": { "type": "string", "format": "HH:MM", "description": "Return time (24h). Required with return-date." },
        "pickup-location": { "type": "string", "description": "Location code. Included in checkout_url output." },
        "return-location": { "type": "string", "description": "Location code. Included in checkout_url output." },
        "min": { "type": "integer", "description": "Minimum daily rate in EUR" },
        "max": { "type": "integer", "description": "Maximum daily rate in EUR" },
        "category": { "type": "string", "description": "Comma-separated category filter", "values": ["small", "medium", "large", "estate", "suv", "suv_4x4", "van", "luxury"] },
        "fuel": { "type": "string", "description": "Comma-separated fuel filter", "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"] },
        "deposit": { "type": "string", "description": "Filter by deposit requirement", "values": ["yes", "no"] },
        "manufacture_year": { "type": "integer", "description": "Minimum manufacture year (e.g., 2020)" },
        "per_page": { "type": "integer", "default": 20, "max": 50 },
        "page": { "type": "integer", "default": 1 }
      },
      "response_fields": {
        "slug": "Unique car identifier for checkout URLs",
        "name": "Brand and model (e.g., 'Volkswagen Golf 5')",
        "category": "Vehicle category code",
        "transmission": "Transmission type code (at/mt/am)",
        "fuel": "Fuel type code",
        "seats": "Number of seats",
        "price_per_day_eur": "Daily rate in EUR (client price including 5% platform fee)",
        "deposit_eur": "Deposit in EUR. 0 = no deposit, no card needed for authorization",
        "locations": "Array of location codes where this car is available",
        "image_url": "Car thumbnail URL (may be null)",
        "checkout_url": "Direct checkout link. Includes dates/locations when provided in request."
      },
      "examples": [
        {
          "request": "Automatic SUVs under 50 EUR/day at Tirana Airport, May 15-20",
          "url": "https://cria.al/api/ai/cars?category=suv,suv_4x4&transmission=at&max=50&pickup-date=2026-05-15&pickup-time=10:00&return-date=2026-05-20&return-time=12:00&pickup-location=tia&return-location=tia"
        },
        {
          "request": "All cars with no deposit",
          "url": "https://cria.al/api/ai/cars?deposit=no"
        }
      ]
    },
    "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", "values": ["yes", "no"] },
        "child_seat": { "type": "string", "values": ["yes", "no"] },
        "driver_age": { "type": "integer", "description": "Driver's age (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 with border crossing", "url": "https://cria.al/rent-a-car/?seats=7&fuel=diesel&border_crossing=yes" },
        { "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",
            "fuel": "Pre-purchased fuel",
            "bs": "Baby/child seat",
            "sc": "Snow chains"
          }
        }
      },
      "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" }
      ]
    }
  },
  "pages": {
    "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",
    "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"
  }
}
