Documentation

curl "https://agentskb-api.agentskb.com/api/free/"

{
  "name": "AgentsKB API",
  "version": "1.0.0",
  "description": "Researched Q&A knowledge base for technical questions",
  "status": "production",
  "endpoints": [
    "/health",
    "/stats",
    "/ask",
    "/ask-batch",
    "/search"
  ],
  "stats": {
    "total_questions": 32354,
    "domains": 0,
    "accuracy": 99
  }
}

curl "https://agentskb-api.agentskb.com/api/free/health"

{
  "status": "healthy",
  "timestamp": "2025-11-11T00:30:00.000Z",
  "uptime": 86400.5,
  "services": {
    "api": {
      "status": "healthy",
      "response_time_ms": 45
    },
    "database": {
      "status": "healthy",
      "type": "Qdrant",
      "response_time_ms": 12
    },
    "vector_search": {
      "status": "healthy",
      "dimension": 384,
      "model": "sentence-transformers/all-MiniLM-L6-v2"
    }
  }
}

curl "https://agentskb-api.agentskb.com/api/free/stats"

{
  "total_questions": 32354,
  "domains": 0,
  "avg_confidence": 99,
  "curated_by": "Claude Sonnet 4.5",
  "verification_rate": 99.96,
  "domains_list": [
    "python",
    "typescript",
    "javascript",
    "nodejs",
    "go",
    "rust",
    "react",
    "vue",
    "nextjs",
    "angular",
    "aws",
    "azure",
    "gcp",
    "terraform",
    "kubernetes",
    "postgresql",
    "mongodb",
    "redis",
    "elasticsearch",
    "docker",
    "jenkins",
    "github-actions",
    "gitlab-ci",
    "fastapi",
    "django",
    "flask",
    "spring",
    "laravel",
    "express",
    "gin",
    "rust",
    "actix",
    "axum",
    "pandas",
    "numpy",
    "tensorflow",
    "pytorch",
    "machine-learning",
    "data-science",
    "blockchain",
    "ethereum",
    "solidity",
    "web3",
    "graphql",
    "rest",
    "microservices",
    "devops",
    "sre"
  ],
  "domain_breakdown": {
    "python": 89,
    "typescript": 76,
    "aws": 65,
    "kubernetes": 54,
    "postgresql": 48,
    "fastapi": 42,
    "docker": 38,
    "react": 35,
    "go": 32,
    "rust": 28
  }
}

curl "https://agentskb-api.agentskb.com/api/free/ask" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What is FastAPI and how is it different from Flask?",
    "domain": "python",
    "tier": "GOLD"
  }'

{
  "question": "What is FastAPI and how is it different from Flask?",
  "answer": {
    "text": "FastAPI is a modern, high-performance web framework for building APIs with Python 3.7+ based on standard Python type hints. Key differences from Flask:\n\n1. **Performance**: FastAPI is one of the fastest Python web frameworks, comparable to NodeJS and Go. It uses Starlette for the web parts and Pydantic for the data parts.\n\n2. **Automatic API Documentation**: FastAPI automatically generates OpenAPI/Swagger documentation and ReDoc, while Flask requires extensions like Flasgger or Flask-RESTPlus.\n\n3. **Type Safety**: Built-in request/response validation using Pydantic models with Python type hints. Flask lacks this built-in feature.\n\n4. **Async Support**: Native support for async/await syntax throughout the framework, while Flask's async support is limited.\n\n5. **Data Validation**: Automatic validation of request/response data with detailed error messages, which Flask requires manual handling for.\n\n6. **Dependency Injection**: Built-in dependency injection system, whereas Flask requires extensions like Flask-Injector.\n\nFastAPI is ideal for building APIs, especially those requiring high performance, data validation, and automatic documentation.",
    "confidence": 0.96,
    "tier": "GOLD",
    "sources": [
      "https://fastapi.tiangolo.com/",
      "https://docs.python.org/3/library/typing.html",
      "https://www.starlette.io/"
    ]
  },
  "meta": {
    "domain": "python",
    "search_time_ms": 42,
    "model": "sentence-transformers/all-MiniLM-L6-v2"
  }
}

curl "https://agentskb-api.agentskb.com/api/free/ask-batch" \
  -H "Content-Type: application/json" \
  -d '{
    "questions": [
      "What is the default max_connections in PostgreSQL?",
      "How do I create an index in PostgreSQL?"
    ]
  }'

{
  "total": 2,
  "found": 2,
  "not_found": 0,
  "answers": [
    {
      "question": "What is the default max_connections in PostgreSQL?",
      "answer": "The default value for max_connections in PostgreSQL is 100...",
      "confidence": 0.99,
      "sources": ["https://www.postgresql.org/docs/current/runtime-config-connection.html"],
      "topic": "postgresql"
    },
    {
      "question": "How do I create an index in PostgreSQL?",
      "answer": "To create an index in PostgreSQL, use CREATE INDEX...",
      "confidence": 0.98,
      "sources": ["https://www.postgresql.org/docs/current/sql-createindex.html"],
      "topic": "postgresql"
    }
  ],
  "processing_time_ms": 62
}

curl "https://agentskb-api.agentskb.com/api/free/search?q=postgresql&domain=database&limit=5"

{
  "query": "postgresql",
  "results": [
    {
      "id": "qa_001",
      "question": "What is PostgreSQL and what are its main features?",
      "answer": "PostgreSQL is a powerful, open-source object-relational database system with over 35 years of active development...",
      "domain": "postgresql",
      "confidence": 0.98,
      "tier": "GOLD",
      "similarity": 0.95
    },
    {
      "id": "qa_045",
      "question": "How do I create an index in PostgreSQL?",
      "answer": "To create an index in PostgreSQL, use the CREATE INDEX command. Here's the basic syntax...",
      "domain": "postgresql",
      "confidence": 0.94,
      "tier": "SILVER",
      "similarity": 0.87
    },
    {
      "id": "qa_123",
      "question": "What is the difference between PostgreSQL and MySQL?",
      "answer": "PostgreSQL and MySQL are both popular relational databases, but they have key differences...",
      "domain": "postgresql",
      "confidence": 0.92,
      "tier": "GOLD",
      "similarity": 0.82
    }
  ],
  "meta": {
    "total": 48,
    "returned": 3,
    "search_time_ms": 28
  }
}