{
  "$schema": "https://consciousportugal.com/schemas/ai-manifest-v1.json",
  "version": "1.0.0",
  "apiVersion": "v1",
  "generatedAt": "2026-02-06T00:00:00Z",
  
  "platform": {
    "name": "Conscious Portugal",
    "domain": "consciousportugal.com",
    "description": "Directory of wellbeing experiences, holistic providers, yoga retreats, meditation workshops, and wellness events in Portugal",
    "tagline": "Discover retreats, workshops, and events in Portugal. Conscious Portugal connects you with holistic events and wellbeing experiences.",
    "founded": "2024",
    "type": "marketplace",
    "categories": ["wellness", "yoga", "meditation", "retreats", "holistic-health", "conscious-living"]
  },

  "regions": {
    "primary": "PT",
    "supported": [
      {"code": "PT-01", "name": "Aveiro"},
      {"code": "PT-02", "name": "Beja"},
      {"code": "PT-03", "name": "Braga"},
      {"code": "PT-04", "name": "Bragança"},
      {"code": "PT-05", "name": "Castelo Branco"},
      {"code": "PT-06", "name": "Coimbra"},
      {"code": "PT-07", "name": "Évora"},
      {"code": "PT-08", "name": "Faro (Algarve)"},
      {"code": "PT-09", "name": "Guarda"},
      {"code": "PT-10", "name": "Leiria"},
      {"code": "PT-11", "name": "Lisboa"},
      {"code": "PT-12", "name": "Portalegre"},
      {"code": "PT-13", "name": "Porto"},
      {"code": "PT-14", "name": "Santarém"},
      {"code": "PT-15", "name": "Setúbal"},
      {"code": "PT-16", "name": "Viana do Castelo"},
      {"code": "PT-17", "name": "Vila Real"},
      {"code": "PT-18", "name": "Viseu"},
      {"code": "PT-20", "name": "Azores"},
      {"code": "PT-30", "name": "Madeira"}
    ]
  },

  "languages": {
    "supported": ["en", "pt"],
    "default": "en",
    "contentLocalization": true
  },

  "datasets": [
    {
      "id": "experiences",
      "name": "Wellness Experiences",
      "description": "Curated wellness experiences including yoga, meditation, spa treatments, and holistic therapies",
      "type": "collection",
      "count": "dynamic",
      "updateFrequency": "daily",
      "format": ["json", "html", "schema.org"],
      "endpoint": "/data/export.json?type=experiences",
      "fields": ["id", "title", "description", "category", "location", "duration", "price", "availability", "provider", "images"]
    },
    {
      "id": "events",
      "name": "Wellness Events & Agenda",
      "description": "Upcoming yoga retreats, meditation workshops, wellness gatherings, and community events",
      "type": "collection",
      "count": "dynamic",
      "updateFrequency": "realtime",
      "format": ["json", "html", "schema.org"],
      "endpoint": "/data/export.json?type=events",
      "fields": ["id", "title", "description", "startDate", "endDate", "location", "organizer", "price", "capacity", "eventStatus"]
    },
    {
      "id": "locations",
      "name": "Venue & Location Data",
      "description": "Wellness centers, yoga studios, retreat venues, and practice spaces",
      "type": "collection",
      "count": "dynamic",
      "updateFrequency": "weekly",
      "format": ["json", "geojson"],
      "endpoint": "/data/export.json?type=locations",
      "fields": ["id", "name", "address", "coordinates", "region", "facilities", "capacity"]
    },
    {
      "id": "providers",
      "name": "Provider Directory",
      "description": "Wellness practitioners, yoga teachers, facilitators, and holistic providers",
      "type": "collection",
      "count": "dynamic",
      "updateFrequency": "weekly",
      "format": ["json", "html"],
      "endpoint": "/data/export.json?type=providers",
      "fields": ["id", "name", "bio", "specialties", "certifications", "languages", "contactPreference"]
    },
    {
      "id": "blog",
      "name": "Wellness Blog Content",
      "description": "Articles on conscious living, mindfulness, yoga tips, and holistic wellbeing",
      "type": "collection",
      "count": "dynamic",
      "updateFrequency": "asPublished",
      "format": ["json", "html", "markdown"],
      "endpoint": "/data/export.json?type=blog",
      "fields": ["id", "title", "excerpt", "content", "author", "publishedDate", "category", "tags"]
    },
    {
      "id": "taxonomy",
      "name": "Category Taxonomy",
      "description": "Hierarchical categorization of activities, modalities, and wellness types",
      "type": "taxonomy",
      "updateFrequency": "monthly",
      "format": ["json"],
      "endpoint": "/data/export.json?type=taxonomy"
    }
  ],

  "endpoints": {
    "discovery": {
      "llmsTxt": "https://consciousportugal.com/llms.txt",
      "aiManifest": "https://consciousportugal.com/ai.json",
      "dataExport": "https://consciousportugal.com/data/export.json",
      "sitemap": "https://consciousportugal.com/sitemap.xml"
    },
    "web": {
      "homepage": "https://consciousportugal.com",
      "experiences": "https://consciousportugal.com/experiences/{slug}",
      "blog": "https://consciousportugal.com/blog/{slug}",
      "events": "https://consciousportugal.com/agenda/{slug}"
    },
    "api": {
      "base": "https://consciousportugal.com/api",
      "version": "v1",
      "status": "Contact for access",
      "documentation": "https://consciousportugal.com/api/docs"
    }
  },

  "authentication": {
    "publicEndpoints": ["/llms.txt", "/ai.json", "/data/export.json", "/sitemap.xml"],
    "requiresAuth": ["/api/*"],
    "methods": ["bearer-token"],
    "contactForAccess": "hello@consciousportugal.com"
  },

  "sla": {
    "availability": "99.5%",
    "responseTime": {
      "p50": "200ms",
      "p95": "500ms",
      "p99": "1000ms"
    },
    "dataFreshness": {
      "experiences": "24h",
      "events": "realtime",
      "blog": "immediate",
      "locations": "7d"
    },
    "support": {
      "email": "hello@consciousportugal.com",
      "responseTime": "48h"
    }
  },

  "licensing": {
    "data": "CC BY-NC 4.0",
    "fullName": "Creative Commons Attribution-NonCommercial 4.0 International",
    "url": "https://creativecommons.org/licenses/by-nc/4.0/",
    "attribution": "Conscious Portugal (consciousportugal.com)",
    "commercialUse": "Contact for licensing",
    "terms": "https://consciousportugal.com/terms-of-service"
  },

  "rateLimit": {
    "requests": {
      "perMinute": 60,
      "perHour": 1000,
      "perDay": 10000
    },
    "burst": 10,
    "backoff": "exponential"
  },

  "caching": {
    "recommended": {
      "llmsTxt": "1d",
      "aiJson": "6h",
      "dataExport": "1h",
      "experiences": "1h",
      "events": "15m"
    },
    "etag": true,
    "lastModified": true,
    "compression": ["gzip", "br"]
  },

  "pagination": {
    "method": "cursor",
    "defaultPageSize": 100,
    "maxPageSize": 1000,
    "parameters": {
      "cursor": "string (opaque token)",
      "limit": "integer (1-1000)",
      "since": "ISO8601 timestamp"
    }
  },

  "filtering": {
    "supported": true,
    "parameters": {
      "type": ["experiences", "events", "blog", "locations", "providers", "taxonomy"],
      "category": "string",
      "region": "ISO 3166-2 code",
      "language": "ISO 639-1 code",
      "status": ["published", "upcoming", "past"],
      "since": "ISO8601 timestamp",
      "fields": "comma-separated list"
    }
  },

  "structuredData": {
    "format": "JSON-LD",
    "vocabularies": ["Schema.org"],
    "types": [
      "Organization",
      "WebSite",
      "Product",
      "Event",
      "Article",
      "Place",
      "Person",
      "Offer",
      "BreadcrumbList"
    ]
  },

  "compatibility": {
    "optimizedFor": [
      "OpenAI GPT agents",
      "Anthropic Claude",
      "Google Gemini",
      "Perplexity AI",
      "Microsoft Copilot",
      "Meta Llama"
    ],
    "standards": [
      "Schema.org",
      "JSON-LD",
      "OpenAPI 3.0",
      "RSS 2.0",
      "Atom 1.0"
    ]
  },

  "deprecation": {
    "policy": "Minimum 6 months notice",
    "notification": "Email + in-manifest warnings",
    "sunset": "HTTP Sunset header",
    "migration": "Documented upgrade paths"
  },

  "monitoring": {
    "healthCheck": "https://consciousportugal.com/health",
    "status": "operational",
    "incidents": "https://status.consciousportugal.com"
  },

  "contact": {
    "general": "hello@consciousportugal.com",
    "technical": "hello@consciousportugal.com",
    "partnerships": "hello@consciousportugal.com",
    "abuse": "hello@consciousportugal.com"
  },

  "meta": {
    "lastUpdated": "2026-02-06T00:00:00Z",
    "version": "1.0.0",
    "schema": "https://consciousportugal.com/schemas/ai-manifest-v1.json",
    "nextUpdate": "2026-03-06T00:00:00Z"
  }
}