API

Open APIs for academic research, education innovation, and developer applications.

Public API Endpoints

All endpoints are served from https://api.learningnav.org/v1 and return JSON responses.

GET/knowledge/node/{id}

Retrieve a knowledge node by its unique identifier. Returns the node's metadata, content, relations, and source attributions.

Example Request

GET https://api.learningnav.org/v1/knowledge/node/computer.science.ai

Example Response

{
  "id": "computer.science.ai",
  "title": "Artificial Intelligence",
  "type": "knowledge_node",
  "fields": {
    "definition": "Artificial intelligence is the simulation of human intelligence...",
    "parent": "Computer Science",
    "related": ["Machine Learning", "Neural Networks", "NLP"]
  },
  "sources": [
    { "type": "textbook", "title": "AI: A Modern Approach", "year": 2020 }
  ],
  "last_updated": "2026-07-15T09:30:00Z",
  "version": 42
}

GET/knowledge/path/{id}

Retrieve a learning path by its unique identifier. Returns the ordered sequence of knowledge nodes, estimated duration, and difficulty level.

Example Request

GET https://api.learningnav.org/v1/knowledge/path/intro-to-programming

Example Response

{
  "id": "intro-to-programming",
  "title": "Introduction to Programming",
  "type": "learning_path",
  "difficulty": "beginner",
  "estimated_hours": 20,
  "nodes": [
    {
      "position": 1,
      "node_id": "computer.science.programming",
      "title": "What is Programming?"
    },
    {
      "position": 2,
      "node_id": "computer.science.programming.variables",
      "title": "Variables and Types"
    }
  ],
  "last_updated": "2026-06-20T14:00:00Z",
  "version": 15
}

GET/knowledge/search

Search knowledge nodes by keyword, tag, or field. Supports pagination and basic filtering by node type and category.

Example Request

GET https://api.learningnav.org/v1/knowledge/search?q=machine+learning&type=knowledge_node&limit=10

Example Response

{
  "query": "machine learning",
  "total_results": 47,
  "page": 1,
  "page_size": 10,
  "results": [
    {
      "id": "computer.science.ai.ml",
      "title": "Machine Learning",
      "type": "knowledge_node",
      "snippet": "Machine learning is a subset of artificial intelligence...",
      "relevance": 0.95
    }
  ]
}

Usage

Academic Research

Access structured knowledge data for citation analysis, knowledge graph research, education studies, and bibliometric investigations. The API provides stable, versioned identifiers suitable for reproducible research.

Education Innovation

Integrate learning paths and knowledge nodes into educational platforms, curriculum design tools, and learning management systems. Build applications that help learners navigate complex knowledge domains.

Developer Applications

Build knowledge-driven applications using the public API. Retrieve structured data to power search tools, knowledge browsers, reference systems, and data visualization projects.

Limitations

The LearningNAV public API does not provide:

User profile data
Recommendation algorithms
AI tutor services
Personalization features

Authentication

Public API requires an API key for rate limiting purposes. Register at /api/register.