/educationcovers two genuinely different use cases under one namespace: factual lookup (universities, countries, educational systems) and interactive learning tools (quizzes, flashcards, study plans). Here's the minimal version of each.
University search — backed by a real dataset, not a guess
/universitiesis ingested from Hipo's university-domains-list (MIT licensed) into our own Supabase table — it's real, current data, re-synced manually against the upstream GitHub source rather than maintained by hand.
fetch("https://aplicious.com/api/v1/education/universities?country=India&name=IIT", {
headers: { "X-API-Key": "lapi_live_••••" },
});Quiz generation — structured, with explanations
/quiz-generatordoesn't return random trivia — it pulls from a structured question bank organized by subject and topic, where every question carries four labeled options, a correct answer, a difficulty tag (easy/medium/hard), and an explanation for why the answer is correct. That last field is what separates a quiz tool from a quiz-shaped guessing game — the user learns something even when they get a question wrong.
fetch("https://aplicious.com/api/v1/education/quiz-generator", {
method: "POST",
headers: { "X-API-Key": "lapi_live_••••", "Content-Type": "application/json" },
body: JSON.stringify({ subject: "biology", topic: "cell-structure", difficulty: "medium", count: 10 }),
});Putting together a study session
async function startQuiz(subject: string, topic: string) {
const res = await fetch("https://aplicious.com/api/v1/education/quiz-generator", {
method: "POST",
headers: { "X-API-Key": process.env.APLICIOUS_KEY!, "Content-Type": "application/json" },
body: JSON.stringify({ subject, topic, count: 10 }),
});
const { data } = await res.json();
return data.questions; // each with options, correct_answer, explanation
}Combine with /flashcard-set for spaced-repetition style review and /study-plan for scheduling, and the namespace covers most of what a self-study or exam-prep app actually needs without a separate content licensing relationship.