Metadata API

Query taxonomies, metrics, available subjects, and per-question knowledge layer metadata.

L2 · 3 creditsDeveloper tier+

2.2.0Overview

The Metadata API allows developers to inspect curriculum mappings, topic hierarchies, available subject dimensions, and platform metrics. Additionally, when calling the L1 Questions API with a Developer or higher plan, metadata is automatically eager-loaded into each question payload inside the metadata property.

2.2.1Endpoints

Explore the available endpoints for taxonomy discovery and platform metrics:

METHODPATHDESCRIPTION

GET/subjectsAll available subjects with question counts and ranges.

GET/subjects/{subject}/topicsTopics and subtopics taxonomy for a subject (requires L2).

GET/subjects/{subject}/yearsYears and counts available for a subject.

GET/subjects/years/{year}Subjects and counts available for a year.

GET/subjects/comprehension-yearsYears containing comprehension passages.

GET/metricsTotal questions, API requests, and developer counts.

2.2.2Metadata Properties

When eager-loaded inside a question resource, the metadata object contains the following properties:

PROPERTYTYPEDESCRIPTION

topicstringCurriculum topic name, e.g. "algebra".

subtopicstringSpecific subtopic, e.g. "quadratic-equations".

difficultyScoreinteger (1-5)Calculated difficulty, where 1 is easiest and 5 is hardest.

estimatedTimeinteger (sec)Estimated student solving time in seconds.

tagsarray [string]Descriptive keywords for concept mapping.

curriculumAlignmentstringSpecific syllabus match code.

classificationConfidencefloat (0-1)Accuracy confidence score of the classifier.

2.2.3Example Response

Example output for GET /subjects/mathematics/topics:

200 OK

{
  "data": [
    {
      "name": "algebra",
      "displayName": "Algebra",
      "questionCount": 120,
      "subtopics": [
        {
          "name": "quadratic-equations",
          "displayName": "Quadratic equations",
          "questionCount": 45
        }
      ]
    }
  ]
}