Testbook APItestbook.com ↗
Access Testbook exam categories, course search, upcoming live classes, and MCQ questions via API. Covers SSC, Banking, Railways, UPSC, and more.
What is the Testbook API?
The Testbook API provides 4 endpoints to query India's government exam preparation platform, covering global content search, exam category listings, upcoming live class schedules, and topic-based MCQ question sets. The search endpoint alone spans nine content types — exams, courses, test series, tests, articles, quizzes, videos, free tests, and previous year papers — filterable by language and content type in a single call.
curl -X GET 'https://api.parse.bot/scraper/fd84e6b2-7849-4708-adad-1bdac1e30c63/search?term=SSC&language=English&search_on=targets%2Ccourses%2CtestSeries%2Ctests%2Carticles%2Cquizzes' \ -H 'X-API-Key: $PARSE_API_KEY'
Global search across Testbook's content including exams (targets), courses, test series, tests, articles, quizzes, videos, free tests, previous year papers, and goal cards. Returns result counts per content type and actual result items.
| Param | Type | Description |
|---|---|---|
| termrequired | string | Search query term (e.g. 'SSC', 'Banking', 'Railways'). |
| language | string | Language for results. Accepts: English, Hindi. |
| search_on | string | Comma-separated list of content types to search. Accepted values: targets, courses, testSeries, tests, articles, quizzes, videos, freeTests, pyp, goalCards. |
{
"type": "object",
"fields": {
"count": "object containing result counts per content type",
"order": "array of content type names in display order",
"results": "object containing arrays of result items per content type",
"totalCount": "object with total result count value and relation"
},
"sample": {
"count": {
"tests": {
"value": 10000,
"relation": "gte"
},
"courses": {
"value": 192,
"relation": "eq"
},
"targets": {
"value": 325,
"relation": "eq"
},
"articles": {
"value": 7292,
"relation": "eq"
}
},
"order": [
"targets",
"courses",
"testSeries"
],
"results": {
"targets": [
{
"_id": "5e6189da5f66e94f14a21f58",
"slug": "ssc-cgl-exam",
"properties": {
"title": "SSC CGL"
}
}
],
"testSeries": [
{
"id": "68e369fddfe41a9c30482098",
"name": "SSC GD Constable 2026 Mock Test Series",
"slug": "ssc-gd-constable",
"freeTestCount": 59,
"paidTestCount": 3019,
"totalAttempts": 1469406
}
]
},
"totalCount": {
"value": 27899,
"relation": "gte"
}
}
}About the Testbook API
Search and Discovery
The search endpoint accepts a term parameter (e.g. SSC, Banking, Railways) and returns a results object keyed by content type, alongside per-type count values and a totalCount aggregate. You can narrow results by passing a comma-separated search_on value — valid types include targets, courses, testSeries, tests, and article. Both English and Hindi responses are supported via the language parameter, which applies across all endpoints.
Exam Categories and Live Classes
list_exam_categories returns the full set of Testbook super groups — SSC Exams, Banking Exams, Railways Exams, Teaching Exams, and others — each with an id, title, logo URL, and a count of exams within that category. The id field feeds directly into get_upcoming_classes as the super_group_id parameter. That endpoint returns an array of lessons, each containing schedule timestamps, instructor details, and series metadata. Pagination is supported via skip and limit parameters.
MCQ Question Sets
get_questions_by_topic retrieves multiple-choice questions for a specific topic, identified by its URL slug (e.g. mcq-on-research-methodology--5eea6a0d39140f30f369e1a5). Each question object includes question_text, options, answer, solution, and a question_number. The response also exposes topic_name, breadcrumbs (for subject hierarchy context), and total_questions. Each topic page returns up to approximately 15 questions.
The Testbook API is a managed, monitored endpoint for testbook.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when testbook.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official testbook.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build an exam discovery tool that lists all Testbook super groups and their target exam counts using
list_exam_categories. - Aggregate upcoming free live class schedules across exam categories for a consolidated study planner using
get_upcoming_classes. - Power a search autocomplete or content index by querying the
searchendpoint filtered tocoursesortestSeriescontent types. - Create a quiz application by fetching MCQ question sets with answers and solutions via
get_questions_by_topic. - Build a multilingual study dashboard by requesting both English and Hindi responses from any endpoint using the
languageparameter. - Monitor newly available free tests or previous year papers by regularly searching for exam-specific terms and checking the
testscontent type count. - Enrich an exam preparation app with subject breadcrumbs and topic hierarchy data returned by
get_questions_by_topic.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Testbook have an official public developer API?+
What does the `search` endpoint return, and can I filter by content type?+
results object with arrays of matched items per content type, a count object with per-type figures, and a totalCount aggregate. You can filter by passing a comma-separated search_on value — accepted types are targets, courses, testSeries, tests, and article. Omitting search_on returns results across all supported types.How do I get upcoming classes for a specific exam category like SSC or Banking?+
list_exam_categories first to retrieve category objects. Each object contains an id field. Pass that id as the super_group_id parameter to get_upcoming_classes. The default, when no super_group_id is provided, is the Teaching Exams category.Does the API expose individual course or test series detail pages?+
search endpoint), exam category metadata, live class schedules, and topic-level MCQ sets. Detailed course pages, pricing, enrollment status, or individual test content are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting specific course or test series detail pages.Are there pagination limits for `get_upcoming_classes` or `get_questions_by_topic`?+
get_upcoming_classes supports skip and limit parameters for pagination, so you can page through lesson results incrementally. get_questions_by_topic returns up to approximately 15 questions per topic page and does not currently expose a pagination parameter — the count reflects what appears on a single topic page.