Managing & Fetching Novels
SdashAPI supports a completely separate ecosystem for Literature Novels (e.g., Things Fall Apart, The Lion and the Jewel). These novel endpoints return rich JSON metadata including themes, chapter summaries, character lists, and more.
1. Fetching the Novels List
GET /api/v4/novelsThis endpoint retrieves the basic information of all registered novels. It returns the ID, title, author, cover image, and whether the novel has associated practice questions.
fetch('https://sdashapi.com/api/v4/novels', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => console.log(data));2. Fetching Deep Novel Details
GET /api/v4/novel?id=X
Provides the full JSON structure of the novel. Note: V1 API access is restricted and will only return basic string fields. V2, V3, and V4 provide the deep arrays like characters, themes, and chapter_summaries.
fetch('https://sdashapi.com/api/v4/novel?id=1', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => console.log(data.data.themes));3. Fetching Practice Questions
GET /api/v4/novel/q?novel_id=X
Literature novels have their own dedicated practice questions to avoid polluting standard exam topics. This endpoint uses our standard pagination system (?page=1&limit=20) and deducts credits similarly to the core /api/v4/q endpoint.
fetch('https://sdashapi.com/api/v4/novel/q?novel_id=1&page=1&limit=10', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => {
console.log('Questions:', data.data);
console.log('Pagination:', data.pagination);
});