curl -X POST "https://vlsiddarth-knowledge-universe.hf.space/v1/signup?email=you@company.com"

{
  "status": "created",
  "api_key": "ku_test_abc123...",
  "tier": "free",
  "calls_limit": 500,
  "message": "Save your API key — it won't be shown again."
}

curl -X POST https://vlsiddarth-knowledge-universe.hf.space/v1/discover \
  -H "X-API-Key: ku_test_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"topic":"transformer architecture","difficulty":3,"formats":["pdf","github"]}'

{
  "decay_scores": {
    "arxiv:2302.14017v1": {
      "decay_score": 0.504,
      "freshness": 0.496,
      "label": "stale",
      "age_days": 1107
    }
  },
  "coverage_intelligence": {
    "confidence": 0.71,
    "confidence_label": "high",
    "coverage_warning": false,
    "suggested_queries": []
  }
}

curl https://vlsiddarth-knowledge-universe.hf.space/v1/usage \
  -H "X-API-Key: ku_test_abc123..."

import requests

resp = requests.post(
    "https://vlsiddarth-knowledge-universe.hf.space/v1/discover",
    headers={"X-API-Key": "ku_test_abc123..."},
    json={"topic": "RAG retrieval", "difficulty": 3},
)
data = resp.json()

curl -X POST "https://vlsiddarth-knowledge-universe.hf.space/v1/signup?email=you@company.com"

curl -X POST https://vlsiddarth-knowledge-universe.hf.space/v1/discover\
  -H "X-API-Key: ku_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "transformer architecture",
    "difficulty": 3,
    "formats": ["pdf","github","stackoverflow"],
    "max_results": 10
  }'

import requests

resp = requests.post(
    "https://vlsiddarth-knowledge-universe.hf.space/v1/discover",
    headers={"X-API-Key": "ku_test_..."},
    json={
        "topic": "transformer architecture",
        "difficulty": 3,
        "formats": ["pdf", "github"],
    },
).json()

# Decay scores
for sid, d in resp["decay_scores"].items():
    print(f"{d['label']:8} score={d['decay_score']} {sid}")

# Coverage confidence
cov = resp["coverage_intelligence"]
if cov["coverage_warning"]:
    print("Low confidence. Try:", cov["suggested_queries"])

curl -X POST https://vlsiddarth-knowledge-universe.hf.space/v1/knowledge \
  -H "X-API-Key: ku_test_..." \
  -H "Content-Type: application/json" \
  -d '{"topic":"RAG retrieval","difficulty":3,"output":"embeddings"}'

curl https://vlsiddarth-knowledge-universe.hf.space/v1/usage \
  -H "X-API-Key: ku_test_..."

{
  "tier": "free",
  "calls_used": 4,
  "calls_limit": 500,
  "calls_remaining": 496,
  "reset": "1st of next month"
}

curl https://vlsiddarth-knowledge-universe.hf.space/v1/formats

curl https://vlsiddarth-knowledge-universe.hf.space/v1/crawlers

{ "status": "healthy", "version": "1.0.0", "redis": "connected" }

decay = 1 - 0.5 ^ (age_days / half_life_days)
freshness = 1 - decay

"coverage_intelligence": {
  "confidence": 0.36,              // cosine similarity: query vs top results
  "confidence_label": "low",        // "high" | "medium" | "low" | "none"
  "coverage_warning": true,
  "warning_message": "Low confidence (0.36) — results may not fully match intent.",
  "suggested_queries": [
    "attention mechanism self-attention explained",
    "transformer encoder decoder tutorial",
    "attention is all you need paper explained"
  ],
  "top_result_similarities": [
    { "title": "A Survey of Graph Transformers...", "similarity": 0.377 }
  ]
}