Developer API
A keyed JSON API over the curriculum structure behind Revision Genie, plus the tutoring and question generation that sit on top of it. A prepaid balance, no contract, no minimum.
Free to join. One top-up unlocks the curriculum data endpoints for good, and the AI endpoints spend that same balance per call.
Curriculum data
Mapping a product to the UK curriculum is months of work before you write a line of your own feature. These endpoints are that work, kept current by the team that maintains it for our own site.
GET /api/v1/subjectsEvery subject in the catalogue, with its qualification and exam board. The starting point for everything else, because the ids it returns are what the other endpoints take.
GET /api/v1/subjects/{subjectId}/treeOne subject with both of its trees: the teaching curriculum and the exam specification hierarchy, each as topics containing subtopics.
GET /api/v1/searchType-ahead search across subjects, topics, subtopics, community lessons, quizzes, flashcard sets and mocks. Built for a search box, so it answers a partial word.
GET /api/v1/subtopics/{subtopicId}/spec-pointsThe specification reference codes a subtopic is mapped to, with the unit they sit in and a link to the exam board’s own published document.
Specification endpoints return reference codes, unit names, our own subtopic mapping and a link to the board’s published document. They never return the board’s own wording, and past papers and mark schemes are not part of the API.
Specification-point mapping is rolling out subject by subject, so a subject we have not reached yet answers with no references rather than an error. Ask us where a subject you depend on has got to.
AI endpoints
POST /api/v1/alignMatch your own text, a lesson plan or a scheme of work, against one subject’s subtopics, and get back the closest matches with a ranking score.
POST /api/v1/genies/{shortName}/chatOne stateless turn with a subject genie: our tutor persona for a specific qualification and board, streamed as NDJSON or returned whole.
POST /api/v1/chatOne stateless turn with our general study tutor, or with a custom genie you shape per request. Same price as a subject genie message, and nothing you send is kept.
POST /api/v1/questions/generateA set of questions with their answers, as plain text: written questions with mark schemes, multiple-choice questions with options and the correct answer, or both. Anchor a set on one of our subtopics or on a topic in your own words.
Chat is stateless by design. We do not read or write anything about your users, which keeps you the controller of their data and us out of it entirely.
curl https://www.revisiongenie.com/api/v1/subjects?qualification=GCSE \
-H "Authorization: Bearer rgk_live_..."
{
"subjects": [
{
"id": "6612a0f4e1b2c3d4e5f60718",
"name": "Biology",
"qualification": "GCSE",
"examBoard": "AQA"
}
],
"count": 1
}Every endpoint is JSON over HTTPS, versioned under /api/v1/, and authenticated with a bearer key. Rate limits are 120 requests a minute per key, or 30 on the AI endpoints.
Pricing
Top your balance up in pounds and spend it on the AI endpoints. The amount you pay is the balance you get, it does not expire, and there is no monthly minimum. Your first top-up also unlocks the curriculum data endpoints permanently, and reading them never spends any of it.
Top up
£10
£10 of balance
Top up
£25
£25 of balance
Top up
£100
£100 of balance
Prices are current and may change with notice. The figures on this page, in the docs and on your invoice all come from the same place, so they cannot disagree.
Before you build
Revision Genie is an independent product and is not affiliated with or endorsed by AQA, Pearson Edexcel, OCR, WJEC or Eduqas. Board names appear in our data only to describe which qualification a course relates to.
Use of the API is governed by the developer terms, which cover what you may do with the data, the attribution we ask for on genie-backed surfaces, and our right to change or withdraw an endpoint. Read them before you integrate.