jjwxc.net APIjjwxc.net ↗
Access Jinjiang Literature City novel metadata, chapter lists, full chapter text, author profiles, and rankings via 6 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/87bbfd85-7537-44a9-ac67-e8d7f51a0225/get_novel_info?novelid=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch novel metadata by novel ID using the mobile API. Returns comprehensive information including title, author, genre, tags, synopsis, cover image, word count, chapter count, score, and VIP status.
| Param | Type | Description |
|---|---|---|
| novelidrequired | string | The numeric novel ID (e.g. "3", "4001734"). |
{
"type": "object",
"fields": {
"novelName": "string - title of the novel",
"novelSize": "string - word count",
"authorName": "string - author's display name",
"novelClass": "string - genre classification",
"novelIntro": "string - synopsis/introduction text",
"novelScore": "string - accumulated score",
"novelChapterCount": "string - total chapter count"
},
"sample": {
"data": {
"novelId": "3",
"authorId": "2",
"novelName": "烟花之舞",
"novelSize": "7,006",
"novelTags": "正剧",
"authorName": "慕容",
"novelClass": "原创-言情-近代现代-爱情-女主",
"novelIntro": "一个中篇...",
"novelScore": "246.3万",
"novelChapterCount": "1"
},
"status": "success"
}
}About the jjwxc.net API
The Jinjiang Literature City (jjwxc.net) API provides 6 endpoints covering novel metadata, chapter listings, chapter content, author profiles, search, and ranked novel lists. Use get_novel_info to retrieve a novel's title, word count, genre, synopsis, and score by numeric novel ID, or get_novel_chapters to pull the full chapter list with per-chapter word counts, publication dates, and lock/VIP status flags.
Novel Data and Chapter Access
The get_novel_info endpoint accepts a numeric novelid and returns fields including novelName, authorName, novelClass, novelIntro, novelSize, novelScore, and novelChapterCount. These give a complete summary of a title without fetching individual chapters. When you need the chapter index, get_novel_chapters returns a chapterlist array where each entry carries chapterid, chaptername, chaptersize, chapterdate, isvip, and islock — useful for determining which chapters are freely readable before requesting their content.
Chapter Content and Search
To read a specific chapter, call get_chapter_content with both novelid and chapterid (obtained from the chapter list). The response includes the full content string with preserved line breaks, the chapterName, and the chapterSize. VIP-locked chapters return an error message rather than text — the islock field from the chapter list helps you identify these in advance. The search_novels endpoint accepts a query string and an optional type parameter to narrow results by title (1), author (2), protagonist (4), supporting character (5), or other (6), with page-based pagination.
Rankings and Author Profiles
get_rankings retrieves ranked novel lists by passing a type integer: 5 for monthly, 6 for seasonal, 7 for total score, or 8 by word count. Each ranking entry includes rank, novel_name, novel_url, author, and author_url. The author_url can be parsed to extract an author ID for use with get_author_profile, which returns the author's author_name and a works array containing each title's name, type, status, word_count, and score.
- Build a novel recommendation tool using genre (
novelClass), score (novelScore), and word count (novelSize) fromget_novel_info. - Track which chapters of a novel are VIP-locked using the
isvipandislockfields fromget_novel_chapters. - Aggregate monthly and seasonal trending novels by querying
get_rankingswith type 5 and 6. - Compile an author bibliography by fetching all works, statuses, and scores via
get_author_profile. - Index free-to-read chapter text for full-text search using
get_chapter_contentcombined with the lock status from the chapter list. - Search a corpus of novels by protagonist name using
search_novelswith type 4. - Compare novel performance across score and word count rankings by querying
get_rankingswith type 7 and 8.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Jinjiang Literature City have an official developer API?+
What does `get_novel_chapters` return, and how do I tell which chapters are paywalled?+
chapterlist array and a total count. Each chapter object includes an isvip flag indicating VIP status and an islock flag indicating whether the content is currently locked. Checking these two fields before calling get_chapter_content lets you avoid requests that would return an error instead of text.Can I retrieve the content of VIP-locked chapters?+
get_chapter_content is called for a VIP or locked chapter, the response returns an error message in place of content. The API covers freely accessible chapters in full. You can fork it on Parse and revise it to add authentication-based access if your use case requires VIP content.Does the API expose reader comments or reviews for novels?+
How does pagination work in `search_novels`?+
page parameter alongside your query and optional type to navigate through result pages. The response returns an items array for that page; the API does not currently expose a total result count, so iteration should continue until an empty array is returned.