OPEN ACCESS · CORS ENABLED · NO API KEY REQUIRED

ALevelord-Math Developer API

A free, high-performance public API and open dataset delivering 13,197 past-paper questions, worked mark scheme steps, and 1,143 exam papers from Cambridge International (9709) and Pearson Edexcel IAL (2018–2025).

Base URL: https://maths.lovx.me 13,197 Questions Indexed Format: JSON

QUICK START

CURL / FETCH

No signups, tokens, or headers are needed. All endpoints support standard HTTP GET requests with cross-origin resource sharing (CORS) enabled.

cURL & PowerShell Quick Start

# macOS / Linux / Git Bash:
curl -s https://maths.lovx.me/api/v1/stats

# Windows PowerShell:
curl.exe https://maths.lovx.me/api/v1/stats
# Or native PowerShell (formatted JSON):
Invoke-RestMethod https://maths.lovx.me/api/v1/stats

API ENDPOINT DIRECTORY

Available Endpoints

Explore metadata endpoints and direct bulk dataset URLs.

GET/api/v1/stats

Returns high-level statistics, syllabus specifications, paper counts by exam board (Cambridge 9709 vs Pearson Edexcel IAL), and year coverage.

Response Structure:

status: API status string ("ok")
data.totalQuestions: Total indexed questions (13197)
data.totalPapers: Total cataloged papers (1143)
data.boards: Syllabus-level metrics for CIE and Edexcel IAL

GET/api/v1/topics

Returns the full taxonomy of 26 mathematics topics organized across 4 major groups (Pure Mathematics, Mechanics, Statistics, Decision).

Response Structure:

topics[]: Array of topic objects containing id, label, group, and UI color hex.

CDN/data/papers.jsonDownload (1.3 MB)

Direct CDN download of all 1,143 listed past examination papers. Includes paper codes, exam boards, session details, and verified PDF download links for Question Papers, Mark Schemes, and Examiner Reports.

CDN/data/questions.jsonDownload (19.3 MB)

Direct CDN download of all 13,197 individual question records. Each record includes question part labels, mark allocations, math topic tags, paraphrased prompt summaries, worked mark scheme solution guides, exact PDF page ranges, and examiner difficulty notes.

INTERACTIVE API CONSOLE

READY

Click Test Live above or select an endpoint to inspect real-time responses:

Response JSON (/api/v1/stats)

Click "Test Live" or an endpoint above to see real-time output.

CODE SNIPPETS

CLIENT EXAMPLES

JavaScript (Fetch / Node.js / Browser)

// Fetch dataset statistics
const response = await fetch('https://maths.lovx.me/api/v1/stats');
const data = await response.json();
console.log('Total questions:', data.data.totalQuestions);

// Stream bulk questions JSON
const qRes = await fetch('https://maths.lovx.me/data/questions.json');
const { records } = await qRes.json();
const integrationQuestions = records.filter(q => q.topicIds.includes('integration'));
console.log('Integration questions count:', integrationQuestions.length);

Python (requests)

import requests

# Fetch API stats
res = requests.get('https://maths.lovx.me/api/v1/stats')
data = res.json()
print(f"Total papers: {data['data']['totalPapers']}")
print(f"Total questions: {data['data']['totalQuestions']}")

# Filter China Regional Pure Maths 2 (P2A) questions
q_res = requests.get('https://maths.lovx.me/data/questions.json')
questions = q_res.json()['records']
p2a_questions = [q for q in questions if q['paperCode'] == 'WMA12/01A']
print(f"Found {len(p2a_questions)} P2A China regional questions.")

DATA SCHEMA

QUESTION RECORD OBJECT

Field	Type	Description
`id`	`string`	Unique question identifier (e.g. `"cie-2023-s-12-q03a"`).
`board`	`"CIE" \| "Edexcel IAL"`	Examination board.
`paperCode`	`string`	Official paper component code (e.g. `"9709/12"`, `"WMA12/01A"`).
`questionNumber`	`number`	Question number on paper.
`questionPart`	`string \| null`	Sub-part label (e.g. `"3(b)(i)"`).
`marks`	`number`	Total marks awarded for this question part.
`primaryTopicId`	`string`	Primary math taxonomy topic key (e.g. `"integration"`, `"vectors"`).
`summary`	`string`	Concise paraphrased mathematical prompt.
`answerGuide`	`string`	Worked solution method and official mark scheme steps.
`qpUrl`	`string`	Direct URL to the official Question Paper PDF.
`msUrl`	`string`	Direct URL to the official Mark Scheme PDF.
`qpPages`	`[number, number]`	1-indexed page range in the Question Paper PDF.
`msPages`	`[number, number]`	1-indexed page range in the Mark Scheme PDF.
`difficultyEvidence`	`string \| null`	Official examiner report analysis explaining candidate errors (if flagged).