Free and open source novel API that provides seamless access to detailed novel information from various sources.
- Retrieve novel title information, chapters, and chapter contents
- Explore the latest, popular, newest, and completed novel per source
- Dedicated search endpoints for each source for a focused search experience
- Node.js - Runtime environment
- Express - Web framework
- Cheerio - Web scraping library
- Axios - HTTP client
GET /
Returns a welcome message.
Search each source independently with the following endpoints:
-
NovelFire Search
GET /novel/novelfire/search?query={query}
- Searches for novel titles on NovelFire by query. Optional: Empty
query
resulting to defaultshadow
- Searches for novel titles on NovelFire by query. Optional: Empty
Endpoint | Description |
---|---|
GET /novel/novelfire/info?novelId={novelId} |
Fetches details of a specific novel by ID. |
GET /novel/novelfire/chapters?novelId={novelId} |
Retrieves list of chapters for a specific novel. |
GET /novel/novelfire/read/chapter?chapterId={chapterId} |
Retrieves chapter content for a specific novel chapter. |
GET /nove/novelfire/latest?page={page} |
Lists the latest novel titles (paginated) (default = 1}. |
GET /novel/novelfire/newest?page={page} |
Lists newest novel titles (paginated) (default = 1). |
GET /novel/novelfire/completed?page={page} |
Lists completed novel titles (paginated) (default = 1). |
GET /novel/novelfire/rank?type={type} |
Lists ranking novels (type: ["daily-rank","monthly-rank","alltime-rank","hot-rank","rating-rank","mostlib-rank"]) (default = "daily-rank"). |
GET /novel/novelfire/search?query={query} |
Lists of results from query (default = "shadow"). |
- Node.js (v14 or higher)
- npm or yarn
-
Clone this repository:
git clone https://github.com/denzkie2003/DenZ_Api.git cd DenZ_Api
-
Install dependencies:
npm install
-
Set up environment variables in a
.env
file as needed. -
Run the server:
npm start
-
The API will be accessible at
http://localhost:3000
.
Test the API by visiting endpoints like:
http://localhost:3000/novel/novelfire/info?novelId={novelId}
– Get novel detailshttp://localhost:3000/novel/novelfire/latest
– Get novel latest chaptershttp://localhost:3000/novel/novelfire/search?query={query}
– Search for novel on NovelFire
denzk_api/
├── src/
│ ├── fetcher/ # Fetcher functions for each route
│ ├── routes/ # API route definitions
│ ├── scraper/ # Web scraping logic for each source
│ └── utils/ # Utility functions
├── assets/ # Static assets including logo
├── .env # Environment variables (gitignored)
├── package.json # Project dependencies and scripts
├── app.js # Main server entry point
└── README.md # Documentation
- Fork the project
- Create your feature branch:
git checkout -b feature/AmazingFeature
- Commit your changes:
git commit -m 'Add some AmazingFeature'
- Push to the branch:
git push origin feature/AmazingFeature
- Open a pull request
Distributed under the MIT License. See LICENSE
for more information.
Your Name – warlock071603@gmail.com
Project Link: https://github.com/denzkie2003/DenZ_Api