# GET request
curl "https://api.trygroundai.com/search?query=how+to+authenticate&top_k=10" \
  -H "Authorization: Bearer gnd_your_api_key"

# POST request
curl -X POST https://api.trygroundai.com/search \
  -H "Authorization: Bearer gnd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how to authenticate",
    "top_k": 10,
    "max_tokens": 4000,
    "source_ids": ["source-uuid-1", "source-uuid-2"]
  }'

{
  "results": [
    {
      "content": "# POST /auth/login\nOperation ID: login\n\nAuthenticate with username and password...",
      "score": 0.92,
      "token_count": 150,
      "citation": {
        "chunk_id": "chunk-uuid",
        "source_id": "source-uuid",
        "source_name": "Auth API",
        "path": "https://api.example.com/openapi.json",
        "symbol": "login",
        "version_ref": "v2.0.0",
        "language": "openapi",
        "chunk_type": "openapi"
      },
      "freshness_days": 5.2,
      "is_stale": false
    }
  ],
  "total_results": 10,
  "total_tokens": 1500,
  "sources_searched": 3,
  "sources_with_results": 2,
  "evidence_quality": {
    "score": 0.75,
    "evidence_count": 10,
    "avg_freshness_days": 8.5,
    "has_conflicts": false,
    "confidence": "high"
  },
  "staleness_summary": {
    "total_sources": 3,
    "fresh_sources": 2,
    "stale_sources": 1,
    "staleness_budget_days": 30,
    "stale_source_names": ["Old Docs"]
  },
  "conflicts": [],
  "warnings": [],
  "query": "how to authenticate",
  "search_time_ms": 45
}