{
    "name": "VIVACITY",
    "version": "1.0.0",
    "description": "VIVACITY structured data API for AI agents",
    "openapi_url": "https://vivacity.ro/agent-data/api/openapi.json",
    "base_url": "https://vivacity.ro/agent-data/api/v1",
    "last_updated": "2026-06-24T14:12:28.056517Z",
    "endpoints": {
        "apartament": {
            "description": "apartament",
            "schema_org_type": "Apartment",
            "type": "single",
            "entry_count": 5,
            "example_url": "https://vivacity.ro/agent-data/api/v1/apartament",
            "markdown_url": "https://vivacity.ro/agent-data/data/apartament.md",
            "created_at": "2025-11-11T13:26:17.000000Z",
            "updated_at": "2025-11-11T13:26:53.000000Z"
        },
        "compania": {
            "description": "compania",
            "schema_org_type": "Organization",
            "type": "multiple",
            "entry_count": 2,
            "example_url": "https://vivacity.ro/agent-data/api/v1/compania",
            "markdown_url": "https://vivacity.ro/agent-data/data/compania.md",
            "created_at": "2025-11-11T12:16:06.000000Z",
            "updated_at": "2025-11-11T12:16:40.000000Z"
        },
        "customer-support-vivacity": {
            "description": "Customer Support VIVACITY",
            "schema_org_type": "FAQPage",
            "type": "single",
            "entry_count": 1,
            "example_url": "https://vivacity.ro/agent-data/api/v1/customer-support-vivacity",
            "markdown_url": "https://vivacity.ro/agent-data/data/customer-support-vivacity.md",
            "created_at": "2026-04-09T14:24:09.000000Z",
            "updated_at": "2026-04-09T14:31:40.000000Z"
        },
        "filosofia-vivacity": {
            "description": "Filosofia VIVACITY",
            "schema_org_type": "AboutPage",
            "type": "single",
            "entry_count": 1,
            "example_url": "https://vivacity.ro/agent-data/api/v1/filosofia-vivacity",
            "markdown_url": "https://vivacity.ro/agent-data/data/filosofia-vivacity.md",
            "created_at": "2025-12-04T10:18:05.000000Z",
            "updated_at": "2025-12-04T10:18:27.000000Z"
        },
        "portofoliu": {
            "description": "portofoliu",
            "schema_org_type": "ItemList",
            "type": "multiple",
            "entry_count": 1,
            "example_url": "https://vivacity.ro/agent-data/api/v1/portofoliu",
            "markdown_url": "https://vivacity.ro/agent-data/data/portofoliu.md",
            "created_at": "2025-11-11T13:01:26.000000Z",
            "updated_at": "2025-11-11T13:02:46.000000Z"
        }
    },
    "search_endpoints": {
        "keyword_search": {
            "url": "https://vivacity.ro/agent-data/api/v1/search",
            "method": "GET",
            "description": "Search across active endpoints using keywords",
            "example": "https://vivacity.ro/agent-data/api/v1/search?q=DALI&endpoint=apartament",
            "parameters": {
                "q": "Search query (required)",
                "endpoint": "Filter by endpoint slug (optional)",
                "limit": "Number of results (optional, default: 10)"
            }
        },
        "semantic_search": {
            "url": "https://vivacity.ro/agent-data/api/v1/semantic-search",
            "method": "POST",
            "description": "Advanced semantic search with natural language queries",
            "example_body": {
                "query": "apartamente disponibile",
                "filters": {
                    "endpoint": "apartament"
                },
                "limit": 10
            }
        },
        "query_intelligence": {
            "url": "https://vivacity.ro/agent-data/api/v1/query-intelligence",
            "method": "POST",
            "description": "Process natural language queries and get API call instructions",
            "example_body": {
                "query": "Ce apartamente sunt disponibile?",
                "base_url": "https://vivacity.ro/agent-data/api/v1"
            },
            "capabilities_url": "https://vivacity.ro/agent-data/api/v1/query-intelligence/capabilities"
        },
        "smart_discovery": {
            "url": "https://vivacity.ro/agent-data/api/v1/discover",
            "method": "GET",
            "description": "Automatically discover what data is available and get relevant results",
            "example": "https://vivacity.ro/agent-data/api/v1/discover?query=apartamente",
            "post_example": {
                "query": "apartamente disponibile",
                "context": "user mentioned @https://vivacity.ro"
            }
        }
    },
    "instructions": "This site provides structured VIVACITY data for AI agents. Start with GET /api/v1/discover?query=... for natural-language discovery. Use GET /api/v1/search?q=...&endpoint=... for keyword lookup. Read https://vivacity.ro/llms.txt and markdown mirrors under https://vivacity.ro/agent-data/data/ for human-readable content. OpenAPI spec: https://vivacity.ro/agent-data/.well-known/openapi.yaml. No authentication required.",
    "markdown_data_files": {
        "llms_txt": {
            "url": "https://vivacity.ro/llms.txt",
            "description": "Primary AI discovery index"
        },
        "sitemap_md": {
            "url": "https://vivacity.ro/sitemap.md",
            "description": "Markdown sitemap of all content"
        },
        "apartament": {
            "url": "https://vivacity.ro/agent-data/data/apartament.md",
            "description": "All apartament entries as markdown",
            "count": 5
        },
        "compania": {
            "url": "https://vivacity.ro/agent-data/data/compania.md",
            "description": "All compania entries as markdown",
            "count": 2
        },
        "customer-support-vivacity": {
            "url": "https://vivacity.ro/agent-data/data/customer-support-vivacity.md",
            "description": "All customer support vivacity entries as markdown",
            "count": 1
        },
        "filosofia-vivacity": {
            "url": "https://vivacity.ro/agent-data/data/filosofia-vivacity.md",
            "description": "All filosofia vivacity entries as markdown",
            "count": 1
        },
        "portofoliu": {
            "url": "https://vivacity.ro/agent-data/data/portofoliu.md",
            "description": "All portofoliu entries as markdown",
            "count": 1
        }
    },
    "html_data_files": {
        "all_data": {
            "url": "https://vivacity.ro/agent-data/sitemap.html",
            "description": "Complete sitemap with all data from active endpoints",
            "use_case": "When users ask for general information or multiple data types"
        },
        "apartament": {
            "url": "https://vivacity.ro/agent-data/apartament-data.html",
            "description": "All apartament data",
            "count": 5,
            "use_case": "When users ask specifically about apartament"
        },
        "compania": {
            "url": "https://vivacity.ro/agent-data/compania-data.html",
            "description": "All compania data",
            "count": 2,
            "use_case": "When users ask specifically about compania"
        },
        "customer-support-vivacity": {
            "url": "https://vivacity.ro/agent-data/customer-support-vivacity-data.html",
            "description": "All customer support vivacity data",
            "count": 1,
            "use_case": "When users ask specifically about customer support vivacity"
        },
        "filosofia-vivacity": {
            "url": "https://vivacity.ro/agent-data/filosofia-vivacity-data.html",
            "description": "All filosofia vivacity data",
            "count": 1,
            "use_case": "When users ask specifically about filosofia vivacity"
        },
        "portofoliu": {
            "url": "https://vivacity.ro/agent-data/portofoliu-data.html",
            "description": "All portofoliu data",
            "count": 1,
            "use_case": "When users ask specifically about portofoliu"
        }
    },
    "usage_examples": {
        "list_all_endpoints": "GET /api/v1/endpoints",
        "get_endpoint_listings": "GET /api/v1/{endpoint_slug}",
        "search_with_keywords": "GET /api/v1/search?q={query}&endpoint={endpoint_slug}",
        "smart_discovery": "GET /api/v1/discover?query={natural_language_query}",
        "semantic_search": "POST /api/v1/semantic-search with body: {\"query\": \"{natural_language_query}\", \"filters\": {\"endpoint\": \"{endpoint_slug}\"}}",
        "get_apartament_listings": "GET https://vivacity.ro/agent-data/api/v1/apartament",
        "search_apartament": "GET https://vivacity.ro/agent-data/api/v1/search?q={query}&endpoint=apartament",
        "get_compania_listings": "GET https://vivacity.ro/agent-data/api/v1/compania",
        "search_compania": "GET https://vivacity.ro/agent-data/api/v1/search?q={query}&endpoint=compania",
        "get_customer-support-vivacity_listings": "GET https://vivacity.ro/agent-data/api/v1/customer-support-vivacity",
        "search_customer-support-vivacity": "GET https://vivacity.ro/agent-data/api/v1/search?q={query}&endpoint=customer-support-vivacity",
        "get_filosofia-vivacity_listings": "GET https://vivacity.ro/agent-data/api/v1/filosofia-vivacity",
        "search_filosofia-vivacity": "GET https://vivacity.ro/agent-data/api/v1/search?q={query}&endpoint=filosofia-vivacity",
        "get_portofoliu_listings": "GET https://vivacity.ro/agent-data/api/v1/portofoliu",
        "search_portofoliu": "GET https://vivacity.ro/agent-data/api/v1/search?q={query}&endpoint=portofoliu"
    },
    "data_schemas": {
        "apartament": {
            "properties": [],
            "schema_org_type": "Apartment",
            "required_fields": [],
            "description": "apartament"
        },
        "compania": {
            "properties": [],
            "schema_org_type": "Organization",
            "required_fields": [],
            "description": "compania"
        },
        "customer-support-vivacity": {
            "properties": [],
            "schema_org_type": "FAQPage",
            "required_fields": [],
            "description": "Customer Support VIVACITY"
        },
        "filosofia-vivacity": {
            "properties": [],
            "schema_org_type": "AboutPage",
            "required_fields": [],
            "description": "Filosofia VIVACITY"
        },
        "portofoliu": {
            "properties": [],
            "schema_org_type": "ItemList",
            "required_fields": [],
            "description": "portofoliu"
        }
    },
    "contact": {
        "website": "https://vivacity.ro",
        "documentation": "https://vivacity.ro/agent-data/.well-known/openapi.yaml",
        "llms_txt": "https://vivacity.ro/llms.txt"
    }
}