Syllabus Benchmarks API

3.7.0Overview

The Syllabus Benchmarks API unlocks our structured curriculum intelligence for developers. Instead of treating past examination questions as unweighted raw strings, this endpoint returns the empirical frequency distribution of topics audited across more than two decades of African examination history.

Whether you are building diagnostic testing engines, weighted revision planners, or AI tutoring systems, you can query topic proportions, average Bloom's difficulty ratings, and representative question samples.

3.7.1GET /v1/benchmarks/topics

Retrieve weighted topic distributions, percentage shares, and difficulty ratings for a subject. Results can be scoped across all examinations or filtered to a specific body (such as jamb, waec, neco, or post_utme).

Query Parameters

Example Request

curl -X GET "https://aloc.com.ng/api/v1/benchmarks/topics?subject=mathematics&examType=jamb" \
  -H "Accept: application/json"

Example Response

{
  "data": {
    "subject": "mathematics",
    "subjectDisplayName": "Mathematics",
    "examType": "jamb",
    "totalQuestions": 1093,
    "window": { "start": 2000, "end": 2024 },
    "topics": [
      {
        "name": "geometry",
        "displayName": "Geometry",
        "questionCount": 222,
        "percentage": 20.3,
        "avgDifficulty": 2.7,
        "years": { "2010": 12, "2015": 14, "2020": 16, "2024": 15 }
      },
      {
        "name": "algebra",
        "displayName": "Algebra",
        "questionCount": 189,
        "percentage": 17.3,
        "avgDifficulty": 2.8,
        "years": { "2010": 10, "2015": 12, "2020": 11, "2024": 14 }
      }
    ]
  },
  "meta": { "status": "success", "cached": true }
}

3.7.2GET /v1/benchmarks/sample

Retrieve representative past examination questions for a specific topic, complete with options, canonical correct answers, and verified step-by-step explanations.

curl -X GET "https://aloc.com.ng/api/v1/benchmarks/sample?subject=mathematics&topic=geometry&examType=jamb" \
  -H "Accept: application/json"

3.7.3GET /v1/benchmarks/subjects

Retrieve the list of all subjects currently cataloged and audited in the benchmark index, along with audited question counts.

curl -X GET "https://aloc.com.ng/api/v1/benchmarks/subjects" \
  -H "Accept: application/json"

3.7.4Interactive Visual Explorer

All data exposed by the Syllabus Benchmarks API can also be explored interactively on our public interface at /benchmarks. Features include:

• Proportional Treemaps — Proportional visual tiles representing topic weight across 20+ years.
• Ranked Tables— Dense tabular rankings sorted by frequency, question volume, or Bloom's difficulty.
• Deep-Linking & Share Mechanics — Direct URL parameter persistence (?topic=algebra) and 1-click WhatsApp sharing.