📱 EyeFull News User API Integration Guide

🚀 Quick Start

Base URL: http://localhost:3000/User-guide (Local) | https://api-d.eyefulnews.com/User-guide (Development) | https://api-d.eyefulnews.com/User-guide (Production)

🚨 Status Codes Reference

Status Code Error Type Description
200 Success Fetch Success
201 Create Create Success
422 Validation Error Invalid request data
401 Unauthorized Missing or invalid JWT token
403 Forbidden Insufficient Role Privilege
404 Not Found Resource not found
409 Conflict Same Details Exists
500 Server Error Internal server error

Common Authentication/Token Invalid Error Responses

{
  "status": 403,
  "success": false,
 "message": "Unauthorized: User not found"
}

{
  "status": 403,
  "success": false,
  "message": "Unauthorized: Invalid token"
}

{
  "status": 403,
  "success": false,
  "message": "Forbidden: Insufficient role permissions"
}

{
  "status": 403,
  "success": false,
  "message": "Unauthorized: Token Not Found"
}


Common Validator Required Fields Check Error Response:

{
  "status": 422,
  "success": false,
  "message": "The following fields are required: FieldA, FieldB and FieldC"
}

{
  "status": 422,
  "success": false,
  "message": "Password must be at least 8 characters long, contain uppercase and lowercase letters, a digit, and a special symbol."
}

{
  "status": 422,
  "success": false,
  "message": "A valid email address is required."
}

{
  "status": 422,
  "success": false,
  "message": "Invalid User number. It must be exactly 10 digits."
}

{
  "status": 422,
  "success": false,
  "message": "Invalid OTP."
}

Common File Upload Image Error Response:

{
    "status": 422,
    "success": false,
    "message": "No image provided for upload."
}

{
    "status": 200,
    "success": false,
    "error": "Only .png, .jpg, and .jpeg formats are allowed"
}

{
    "status": 422,
    "success": false,
    "message": "File too large"
}
sequenceDiagram
    User->>API: 1. Register User (email + password)
    API-->>User: Registration Success + JWT Token

    User->>API: 2. Logout User (with JWT)
    API-->>User: Logout confirmation

    User->>API: 3. Request Password Reset (email + role)
    API-->>User: OTP sent confirmation

    User->>API: 4. Reset Password (email + role + otp + new password)
    API-->>User: Password Reset Success

Posts

Active Post Categories

GET /post/category/filter/Active
Authorization: Bearer <token>
Content-Type: application/json

Query Parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "Post Categories details fetched successfully",
  "postCategories": {
    "postCategories": [
      {
        "postCategoryName": "Work",
        "postCategoryImageURL": "",
        "postCategoryStatus": "Active",
        "postCategoryID": "68f89ab503c0ceee6436dc58",
        "createdAt": "2025-10-22T08:49:57.333Z",
        "updatedAt": "2025-10-22T08:49:57.333Z"
      },
      {
        "postCategoryName": "Stocks",
        "postCategoryImageURL": "",
        "postCategoryStatus": "Active",
        "postCategoryID": "68dcd16d242bcd0d46c2e9da",
        "createdAt": "2025-10-01T06:59:57.392Z",
        "updatedAt": "2025-10-01T07:18:19.652Z"
      }
    ],
    "pagination": {
      "totalRecords": 2,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Single Post Category By postCategoryID

GET /post/category/get/:postCategoryID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Post Category details fetched successfully",
  "PostCategoryData": {
    "_id": "68f89ab503c0ceee6436dc57",
    "postCategoryName": "Work",
    "postCategoryImageURL": "",
    "postCategoryStatus": "Active",
    "postCategoryID": "68f89ab503c0ceee6436dc58",
    "createdAt": "2025-10-22T08:49:57.333Z",
    "updatedAt": "2025-10-22T08:49:57.333Z"
  }
}

Posts

GET /posts/filter/Published
Authorization: Bearer <token>
Content-Type: application/json

Query parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "Posts details fetched successfully",
  "posts": {
    "postsData": [
      {
        "postTitle": "By Reporter",
        "postDescription": "Newss by hyderabad",
        "postedOn": "2025-08-28T22:00:00.000Z",
        "postCategory": {
          "postCategoryName": "Stocks",
          "postCategoryImageURL": "",
          "postCategoryID": "68dcd16d242bcd0d46c2e9da"
        },
        "postReportedDetails": {
          "firstName": "nandini",
          "lastName": "nandini",
          "email": "mandynaidu08@gmail.com",
          "mobileNumber": 8897912823,
          "role": "GuestReporter",
          "profilePic": "https://icon-library.com/images/anonymous-avatar-icon/anonymous-avatar-icon-25.jpg",
          "roleID": "68f4f34f1f39eb821e0d8532"
        },
        "postLanguage": {
          "languageName": "తెలుగు",
          "languageID": "68468543c65a2f4251049d74"
        },
        "postImageURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Posts/68f876d903c0ceee6436dbf6-post.png?X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "postStatus": "Published",
        "postID": "68f876d903c0ceee6436dbf6",
        "userActivityData": {
          "users": [],
          "likes": 0,
          "dislikes": 0,
          "shares": 0,
          "downloads": 0
        }
      }
    ],
    "pagination": {
      "totalRecords": 1,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Posts By Logged User Activity

GET /posts/user/filter/Published
Authorization: Bearer <token>
Content-Type: application/json

Query parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "Posts details fetched successfully",
  "posts": {
    "postsData": [
      {
        "postTitle": "hyderabad news",
        "postDescription": "hyderabad news",
        "postedOn": "2025-10-23T09:51:00.000Z",
        "postCategory": {
          "postCategoryName": "Stocks",
          "postCategoryImageURL": "",
          "postCategoryID": "68dcd16d242bcd0d46c2e9da"
        },
        "postReportedDetails": {
          "firstName": "Admin",
          "lastName": "Admin",
          "email": "srinivas.y@cresolinfoserv.com",
          "mobileNumber": 1234567862,
          "role": "Admin",
          "profilePic": "Eyeful-News/Test/Roles/68405f3c73c0f91e76a21b3d-profile.jpeg",
          "roleID": "68405f3c73c0f91e76a21b3d"
        },
        "postLocationDetails": {
          "locationName": "Hyderabad",
          "locationID": "68f754bc5478eca4f4360374"
        },
        "postLanguage": {
          "languageName": "తెలుగు",
          "languageID": "68468543c65a2f4251049d74"
        },
        "postImageURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Posts/68f9ad407b31ffccda5552e8-post.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T044416Z&X-Amz-Expires=120&X-Amz-Signature=93d9d4ca92ea6ada3b9821a5d7ea2ee09e98fe28448bbdd830342687721e0bc7&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "postStatus": "Published",
        "postID": "68f9ad407b31ffccda5552e8",
        "userActivityData": {
          "user": {
            "userId": "68405f3c73c0f91e76a21b3d",
            "actions": {
              "like": false,
              "dislike": false,
              "share": false,
              "download": false,
              "read": false,
              "isBookmarked": false
            }
          },
          "likes": 0,
          "dislikes": 0,
          "shares": 0,
          "downloads": 0,
          "bookmarks": 0
        }
      }
    ],
    "pagination": {
      "totalRecords": 1,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Single Post By Post ID

GET /posts/get/postId
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Posts details fetched successfully",
  "posts": {
    "postTitle": "Why Bihar stands apart in BJP’s dominance of Hindi heartland",
    "postDescription": "“Wherever Hindu refugees settled after Partition, the Bharatiya Jana Sangh (BJS) began gaining influence while the Communists made an impact wherever there were factories and workers.” This popular saying from the 1950s and 1960s perfectly sums up the politics of Bihar.\n\nIf till 1990, this meant Congress dominance in the state, barring two brief interregnums between 1967-1972 and 1977-1980, it is ",
    "postedOn": "2025-10-23T09:08:00.000Z",
    "postCategory": {
      "postCategoryName": "Politics",
      "postCategoryImageURL": "",
      "postCategoryID": "68c92bc48bd02cff20189264"
    },
    "postReportedDetails": {
      "firstName": "GuestUser",
      "lastName": "",
      "email": "",
      "mobileNumber": 0,
      "role": "User",
      "profilePic": "https://icon-library.com/images/anonymous-avatar-icon/anonymous-avatar-icon-25.jpg",
      "roleID": "68f0da821f39eb821e0d4fb4"
    },
    "postLocationDetails": {
      "locationName": "Kukatpally",
      "locationID": "68f8b327f4c3b2fbf2b79cb4"
    },
    "postLanguage": {
      "languageName": "English",
      "languageID": "68413bdfe7181f45a6050e9e"
    },
    "postImageURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Posts/68f9a3367b31ffccda554d61-post.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T045923Z&X-Amz-Expires=120&X-Amz-Signature=f5e55f257fd5e79bc948226366a840d27c51d019d00efc1e1cec2bcaf98fd803&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "postStatus": "Published",
    "postID": "68f9a3367b31ffccda554d61",
    "userActivityData": {
      "users": [
        {
          "userId": "68f1ce951f39eb821e0d59f6",
          "actions": {
            "like": true,
            "dislike": false,
            "share": false,
            "download": false,
            "read": false,
            "isBookmarked": false
          },
          "_id": "68f9b4ba1f39eb821e0da249"
        }
      ],
      "likes": 1,
      "dislikes": 0,
      "shares": 0,
      "downloads": 0
    },
    "comments": [
      {
        "comment": "super",
        "likes": 0,
        "commentID": "68f9b6171f39eb821e0da271",
        "commentedAt": "2025-10-23T04:59:03.577Z",
        "users": [],
        "user": {
          "_id": "68f1ce951f39eb821e0d59f5",
          "firstName": "",
          "email": "sunnykanagala888@gmail.com",
          "roleID": "68f1ce951f39eb821e0d59f6"
        },
        "replies": [
          {
            "replyID": "68f9b61c1f39eb821e0da27c",
            "comment": "ok",
            "likes": 0,
            "likedUsers": [],
            "user": {
              "_id": "68f1ce951f39eb821e0d59f5",
              "firstName": "",
              "email": "sunnykanagala888@gmail.com",
              "roleID": "68f1ce951f39eb821e0d59f6"
            }
          }
        ]
      }
    ]
  }
}

User Saved Posts By roleId

GET /posts/saved-posts/roleId
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Post status updated successfully",
  "savedPostsData": [
    {
      "postTitle": "Why Bihar stands apart in BJP’s dominance of Hindi heartland",
      "postDescription": "“Wherever Hindu refugees settled after Partition, the Bharatiya Jana Sangh (BJS) began gaining influence while the Communists made an impact wherever there were factories and workers.” This popular saying from the 1950s and 1960s perfectly sums up the politics of Bihar.\n\nIf till 1990, this meant Congress dominance in the state, barring two brief interregnums between 1967-1972 and 1977-1980, it is ",
      "postedOn": "2025-10-23T09:08:00.000Z",
      "postCategory": {
        "postCategoryName": "Politics",
        "postCategoryImageURL": "",
        "postCategoryID": "68c92bc48bd02cff20189264"
      },
      "postLocationDetails": "68f8b327f4c3b2fbf2b79cb4",
      "postLanguage": {
        "languageName": "English",
        "languageID": "68413bdfe7181f45a6050e9e"
      },
      "postImageURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Posts/68f9a3367b31ffccda554d61-post.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T050626Z&X-Amz-Expires=120&X-Amz-Signature=c2fbb30e8e2d2b9095730bef285bc90018a68d427d7549bbfed012280cf37fae&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
      "postStatus": "Published",
      "postID": "68f9a3367b31ffccda554d61",
      "userActivityData": {
        "user": {
          "userId": "68f1ce951f39eb821e0d59f6",
          "actions": {
            "like": true,
            "dislike": false,
            "share": false,
            "download": false,
            "read": false,
            "isBookmarked": true
          },
          "_id": "68f9b4ba1f39eb821e0da249"
        },
        "likes": 1,
        "dislikes": 0,
        "shares": 0,
        "reads": 0,
        "downloads": 0,
        "bookmarks": 1
      }
    },
    {
      "postTitle": "John wick - The 3 Chapters",
      "postDescription": "John wick is a wonderful film with a genre of action and drama where the hero John after losing his dog which is killed by a gangster son. Where he turned into violence and take revenge on them ",
      "postedOn": "2025-10-22T21:49:00.000Z",
      "postCategory": {
        "postCategoryName": "Entertainment",
        "postCategoryImageURL": "",
        "postCategoryID": "68c929dd8bd02cff20189206"
      },
      "postLocationDetails": "68f754bc5478eca4f4360374",
      "postLanguage": {
        "languageName": "English",
        "languageID": "68413bdfe7181f45a6050e9e"
      },
      "postImageURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Posts/68f9041bb90ded762430959b-post.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T050626Z&X-Amz-Expires=120&X-Amz-Signature=a8a2eda18f54e9760e49adad078d408e6db0e42e42bb8bdb7e3a3db0621ffd89&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
      "postStatus": "Published",
      "postID": "68f9041bb90ded762430959b",
      "userActivityData": {
        "user": {
          "userId": "68f1ce951f39eb821e0d59f6",
          "actions": {
            "dislike": true,
            "like": false,
            "share": false,
            "download": false,
            "read": false,
            "isBookmarked": true
          },
          "_id": "68f9b4c11f39eb821e0da257"
        },
        "likes": 0,
        "dislikes": 1,
        "shares": 0,
        "reads": 0,
        "downloads": 1,
        "bookmarks": 2
      }
    }
  ]
}

Shorts

Single Short Category By Short ID

GET /shorts/category/get/:shortCategoryID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Short Category details fetched successfully",
  "shortCategoryData": {
    "shortCategoryName": "Politics",
    "shortCategoryStatus": "Active",
    "shortCategoryID": "68c931148bd02cff201894db",
    "createdAt": "2025-09-16T09:42:44.251Z",
    "updatedAt": "2025-09-16T09:42:44.251Z"
  }
}

Active Short Categories

GET /shorts/category/filter/Active
Authorization: Bearer <token>
Content-Type: application/json

Query Parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "short Categories details fetched successfully",
  "shortCategories": {
    "shortCategories": [
      {
        "shortCategoryName": "Politics",
        "shortCategoryStatus": "Active",
        "shortCategoryID": "68c931148bd02cff201894db",
        "createdAt": "2025-09-16T09:42:44.251Z",
        "updatedAt": "2025-09-16T09:42:44.251Z"
      },
      {
        "shortCategoryName": "Health",
        "shortCategoryStatus": "Active",
        "shortCategoryID": "68c9310a8bd02cff201894d3",
        "createdAt": "2025-09-16T09:42:34.742Z",
        "updatedAt": "2025-09-16T09:42:34.742Z"
      },
      {
        "shortCategoryName": "Entertainment",
        "shortCategoryStatus": "Active",
        "shortCategoryID": "68c931038bd02cff201894cb",
        "createdAt": "2025-09-16T09:42:27.251Z",
        "updatedAt": "2025-10-18T08:22:01.628Z"
      },
      {
        "shortCategoryName": "Devotional ",
        "shortCategoryStatus": "Active",
        "shortCategoryID": "68c930f68bd02cff201894c3",
        "createdAt": "2025-09-16T09:42:14.953Z",
        "updatedAt": "2025-10-12T19:25:20.892Z"
      },
      {
        "shortCategoryName": "Technology",
        "shortCategoryStatus": "Active",
        "shortCategoryID": "68c930e88bd02cff201894bb",
        "createdAt": "2025-09-16T09:42:00.728Z",
        "updatedAt": "2025-09-16T09:42:00.728Z"
      }
    ],
    "pagination": {
      "totalRecords": 5,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Shorts By Logged User Activity

GET /shorts/user/filter/Published
Authorization: Bearer <token>
Content-Type: application/json

Query parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "Shorts details fetched successfully",
  "shorts": {
    "shortsData": [
      {
        "shortPostedOn": "2025-10-23T11:16:00.000Z",
        "shortCategory": {
          "shortCategoryName": "Entertainment",
          "shortCategoryStatus": "Active",
          "shortCategoryID": "68c931038bd02cff201894cb"
        },
        "shortReportedDetails": {
          "firstName": "Admin",
          "lastName": "Admin",
          "email": "srinivas.y@cresolinfoserv.com",
          "mobileNumber": 1234567862,
          "role": "Admin",
          "profilePic": "Eyeful-News/Test/Roles/68405f3c73c0f91e76a21b3d-profile.jpeg",
          "roleID": "68405f3c73c0f91e76a21b3d"
        },
        "shortLanguage": {
          "languageName": "తెలుగు",
          "languageID": "68468543c65a2f4251049d74"
        },
        "shortVideoURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Shorts/68f9c1417b31ffccda5557d5-short.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T055033Z&X-Amz-Expires=120&X-Amz-Signature=4066d7513e915319514320a0dd04ea752560627575cf237963e90e0af3261485&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "shortThumbnailURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/ShortThumbnails/68f9c1417b31ffccda5557d5-short.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T055033Z&X-Amz-Expires=120&X-Amz-Signature=b653a1a4007de7a3220d1482d5dd4bbe146663eed3e70ef6dc270d26133896fd&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "shortStatus": "Published",
        "shortID": "68f9c1417b31ffccda5557d5",
        "createdAt": "2025-10-23T05:46:41.841Z",
        "updatedAt": "2025-10-23T05:46:47.378Z",
        "userActivityData": {
          "user": {
            "userId": "68405f3c73c0f91e76a21b3d",
            "actions": {
              "like": false,
              "dislike": false,
              "share": false,
              "download": false,
              "read": false,
              "isBookmarked": false
            }
          },
          "likes": 0,
          "dislikes": 0,
          "shares": 0,
          "downloads": 0,
          "bookmarks": 0
        },
        "totalComments": 0
      },
      {
        "shortPostedOn": "2025-10-23T09:30:00.000Z",
        "shortCategory": {
          "shortCategoryName": "Entertainment",
          "shortCategoryStatus": "Active",
          "shortCategoryID": "68c931038bd02cff201894cb"
        },
        "shortReportedDetails": {
          "firstName": "Admin",
          "lastName": "Admin",
          "email": "srinivas.y@cresolinfoserv.com",
          "mobileNumber": 1234567862,
          "role": "Admin",
          "profilePic": "Eyeful-News/Test/Roles/68405f3c73c0f91e76a21b3d-profile.jpeg",
          "roleID": "68405f3c73c0f91e76a21b3d"
        },
        "shortLanguage": {
          "languageName": "English",
          "languageID": "68413bdfe7181f45a6050e9e"
        },
        "shortVideoURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Shorts/68f90107b90ded762430952d-short.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T055033Z&X-Amz-Expires=120&X-Amz-Signature=b7e1a68cfd69c78d95b3888cd574fe955735c27098e0e77ac2d1cc1f4a3b5285&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "shortThumbnailURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/ShortThumbnails/68f90107b90ded762430952d-short.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T055033Z&X-Amz-Expires=120&X-Amz-Signature=4a90836f2412cd7ec0a17859dfff15fbd9cbc36528147a72346f80b539c053dc&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "shortStatus": "Published",
        "shortID": "68f90107b90ded762430952d",
        "createdAt": "2025-10-22T16:06:31.274Z",
        "updatedAt": "2025-10-23T03:43:22.524Z",
        "userActivityData": {
          "user": {
            "userId": "68405f3c73c0f91e76a21b3d",
            "actions": {
              "like": false,
              "dislike": false,
              "share": false,
              "download": false,
              "read": false,
              "isBookmarked": false
            }
          },
          "likes": 0,
          "dislikes": 0,
          "shares": 0,
          "reads": 0,
          "downloads": 2,
          "bookmarks": 0
        },
        "totalComments": 0
      }
    ],
    "pagination": {
      "totalRecords": 2,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Single Short By Short ID

GET /shorts/get/shortId
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "short details fetched successfully",
  "shorts": {
    "_id": "68f9c1417b31ffccda5557d4",
    "shortPostedOn": "2025-10-23T11:16:00.000Z",
    "shortCategory": {
      "shortCategoryName": "Entertainment",
      "shortCategoryStatus": "Active",
      "shortCategoryID": "68c931038bd02cff201894cb"
    },
    "shortReportedDetails": {
      "firstName": "Admin",
      "lastName": "Admin",
      "email": "srinivas.y@cresolinfoserv.com",
      "mobileNumber": 1234567862,
      "role": "Admin",
      "profilePic": "Eyeful-News/Test/Roles/68405f3c73c0f91e76a21b3d-profile.jpeg",
      "roleID": "68405f3c73c0f91e76a21b3d"
    },
    "shortLanguage": {
      "languageName": "తెలుగు",
      "languageID": "68468543c65a2f4251049d74"
    },
    "shortVideoURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Shorts/68f9c1417b31ffccda5557d5-short.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T061351Z&X-Amz-Expires=120&X-Amz-Signature=6548886319bec914696546c6e35a7f9cb674f9f16e2fb42cd0fff348877bad6e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "shortThumbnailURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/ShortThumbnails/68f9c1417b31ffccda5557d5-short.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251023%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251023T061351Z&X-Amz-Expires=120&X-Amz-Signature=5059cf40cc0fd10210777e7ee8ee8d4c950c85e260116920d9801ee496a445a9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "shortStatus": "Published",
    "shortID": "68f9c1417b31ffccda5557d5",
    "createdAt": "2025-10-23T05:46:41.841Z",
    "updatedAt": "2025-10-23T05:46:47.378Z",
    "userActivityData": {
      "users": [
        {
          "userId": "68f1ce951f39eb821e0d59f6",
          "actions": {
            "like": true,
            "dislike": false,
            "share": false,
            "download": false,
            "read": false,
            "isBookmarked": false
          },
          "_id": "68f9c6401f39eb821e0da452"
        }
      ],
      "likes": 1,
      "dislikes": 0,
      "shares": 0,
      "downloads": 0
    },
    "comments": [
      {
        "comment": "super",
        "likes": 0,
        "commentID": "68f9c6481f39eb821e0da4bb",
        "commentedAt": "2025-10-23T06:08:08.814Z",
        "users": [],
        "user": {
          "_id": "68f1ce951f39eb821e0d59f5",
          "firstName": "",
          "email": "sunnykanagala888@gmail.com",
          "roleID": "68f1ce951f39eb821e0d59f6"
        },
        "replies": [
          {
            "replyID": "68f9c64e1f39eb821e0da5a0",
            "comment": "ok",
            "likes": 0,
            "user": {
              "_id": "68f1ce951f39eb821e0d59f5",
              "firstName": "",
              "email": "sunnykanagala888@gmail.com",
              "roleID": "68f1ce951f39eb821e0d59f6"
            }
          }
        ]
      }
    ]
  }
}

Novels

Single Novel Category By Novel ID

GET /novel/category/get/:novelCategoryID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Novel Category details fetched successfully",
  "novelCategoryData": {
    "_id": "68f8d4d26f80562c7ceda5cd",
    "novelCategoryName": "Fantasy",
    "novelCategoryStatus": "Active",
    "novelCategoryID": "68f8d4d26f80562c7ceda5ce",
    "createdAt": "2025-10-22T12:57:54.704Z",
    "updatedAt": "2025-10-22T12:57:54.704Z"
  }
}

Novel Categories

GET /novel/category/filter/All
Authorization: Bearer <token>
Content-Type: application/json

Query Parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "Novel Categories details fetched successfully",
  "novelCategories": {
    "novelCategories": [
      {
        "novelCategoryName": "Fantasy",
        "novelCategoryStatus": "Active",
        "novelCategoryID": "68f8d4d26f80562c7ceda5ce",
        "createdAt": "2025-10-22T12:57:54.704Z",
        "updatedAt": "2025-10-22T12:57:54.704Z"
      },
      {
        "novelCategoryName": "Entertainment ",
        "novelCategoryStatus": "Active",
        "novelCategoryID": "68f3371a1f39eb821e0d6d8a",
        "createdAt": "2025-10-18T06:43:38.906Z",
        "updatedAt": "2025-10-18T06:43:38.906Z"
      },
      {
        "novelCategoryName": "Science & Technology",
        "novelCategoryStatus": "Active",
        "novelCategoryID": "68ca67858bd02cff2018a5d1",
        "createdAt": "2025-09-17T07:47:17.041Z",
        "updatedAt": "2025-10-22T13:03:43.289Z"
      },
      {
        "novelCategoryName": "Social",
        "novelCategoryStatus": "Active",
        "novelCategoryID": "68ca67798bd02cff2018a5c9",
        "createdAt": "2025-09-17T07:47:05.902Z",
        "updatedAt": "2025-10-22T13:03:53.960Z"
      }
    ],
    "pagination": {
      "totalRecords": 4,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Single Novel By Novel ID

GET /novels/get/:novelID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Novels details fetched successfully",
  "novels": {
    "title": "Movie",
    "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68fb1fb56462fbc388c74ba5-novel.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045923Z&X-Amz-Expires=120&X-Amz-Signature=b5153ad76f9119285363be5c8c2dca14cfda5e618f65364f604279585093037d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "novelCategory": {
      "novelCategoryName": "Entertainment ",
      "novelCategoryID": "68f3371a1f39eb821e0d6d8a"
    },
    "startDateTime": "2025-10-24T12:11:00.000Z",
    "comingSoon": false,
    "totalChapters": 10,
    "novelLanguage": {
      "languageName": "English",
      "languageID": "68413bdfe7181f45a6050e9e"
    },
    "novelStatus": "Active",
    "novelID": "68fb1fb56462fbc388c74ba5",
    "chapters": [
      {
        "chapterNumber": 1,
        "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter1.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045923Z&X-Amz-Expires=120&X-Amz-Signature=f82b315f3c2d1a7668a3097510cb7033c77fa1ee786a4692915b763b7039e2df&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "fileName": "the-story-of-doctor-dolittle.pdf",
        "readingTime": "2h 46 mins",
        "_id": "68fb1fbb6462fbc388c74bac"
      },
      {
        "chapterNumber": 2,
        "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter2.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045923Z&X-Amz-Expires=120&X-Amz-Signature=310b4d46c8d9c2bd0ecd27fc207db8c7179c6843afe79783ec7813fa99e95322&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "fileName": "CHINA_ebook_sample.pdf",
        "readingTime": "24 mins",
        "_id": "68fb1fbb6462fbc388c74bad"
      },
      {
        "chapterNumber": 3,
        "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter3.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045923Z&X-Amz-Expires=120&X-Amz-Signature=078b035c8601a93665cdf6bd9a0045fc2bcb6d7983ac465bee1ace344f280693&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "fileName": "file-example_PDF_1MB.pdf",
        "readingTime": "1h 0 mins",
        "_id": "68fb1fbb6462fbc388c74bae"
      },
      {
        "chapterNumber": 4,
        "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter4.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045923Z&X-Amz-Expires=120&X-Amz-Signature=0925a618e1919fe8363dbaf8991a8204406fd9c964d556794b24ad49fae1d946&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "fileName": "file-example_PDF_500_kB.pdf",
        "readingTime": "10 mins",
        "_id": "68fb1fbb6462fbc388c74baf"
      },
      {
        "chapterNumber": 5,
        "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter5.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045923Z&X-Amz-Expires=120&X-Amz-Signature=640ac4051d14d6266d95b43758fd8c446196c9f52539e663805a7ac07774f56e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "fileName": "file-sample_150kB.pdf",
        "readingTime": "8 mins",
        "_id": "68fb1fbb6462fbc388c74bb0"
      }
    ],
    "totalTime": "2 hrs 41 mins",
    "userActivityData": {
      "likes": 0,
      "reads": 1
    }
  }
}

Active Novels with Filters

GET /novels/filter/active
Authorization: Bearer <token>
Content-Type: application/json

Query parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "novels details fetched successfully",
  "novels": {
    "novelsData": [
      {
        "categoryName": "Fantasy",
        "novelCategoryID": "68f8d4d26f80562c7ceda5ce",
        "novels": [
          {
            "title": "China",
            "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68fb288f6462fbc388c7515b-novel.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045843Z&X-Amz-Expires=120&X-Amz-Signature=43b7a9bf7e7777032910612c3b70b2054fdde6ab2a29ac7c6cf0eee91de7f242&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "startDateTime": "2025-10-24T12:49:00.000Z",
            "novelID": "68fb288f6462fbc388c7515b",
            "userActivityData": {
              "likes": 0,
              "reads": 1
            }
          }
        ]
      },
      {
        "categoryName": "Entertainment ",
        "novelCategoryID": "68f3371a1f39eb821e0d6d8a",
        "novels": [
          {
            "title": "Movie",
            "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68fb1fb56462fbc388c74ba5-novel.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T045843Z&X-Amz-Expires=120&X-Amz-Signature=f0f320c1f884bef7e5e38c3d62a76d6259b4b32518e327f3901353acb5cd95ac&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "startDateTime": "2025-10-24T12:11:00.000Z",
            "novelID": "68fb1fb56462fbc388c74ba5",
            "userActivityData": {
              "likes": 0,
              "reads": 1
            }
          }
        ]
      }
    ],
    "pagination": {
      "totalRecords": 3,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Novels Based Category

GET /novels/category/novelCategoryID
Authorization: Bearer <token>
Content-Type: application/json

Query parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "novels details fetched successfully",
  "novels": {
    "novelsData": [
      {
        "title": "Movie",
        "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68fb1fb56462fbc388c74ba5-novel.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=9dce05337228bbbf4b713ad0bbf26eaaa26ae151a7a8f20bf551951cb390488b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "novelCategory": {
          "novelCategoryName": "Entertainment ",
          "novelCategoryID": "68f3371a1f39eb821e0d6d8a"
        },
        "startDateTime": "2025-10-24T12:11:00.000Z",
        "comingSoon": false,
        "totalChapters": 10,
        "novelLanguage": {
          "languageName": "English",
          "languageID": "68413bdfe7181f45a6050e9e"
        },
        "novelStatus": "Active",
        "novelID": "68fb1fb56462fbc388c74ba5",
        "chapters": [
          {
            "chapterNumber": 1,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter1.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=998aadb1619fe0067b84dd71284690ad787e4f71b5c6bb4dbae4e9a6f898085d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "the-story-of-doctor-dolittle.pdf",
            "readingTime": "2h 46 mins",
            "_id": "68fb1fbb6462fbc388c74bac"
          },
          {
            "chapterNumber": 2,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter2.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=af7170ebe5b88e08e31f86a92ee61de4bb6b8c58c56af3a763fd57373eeb05de&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "CHINA_ebook_sample.pdf",
            "readingTime": "24 mins",
            "_id": "68fb1fbb6462fbc388c74bad"
          },
          {
            "chapterNumber": 3,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter3.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=602101627d95a50a218c1f9ad63f1aed171aeeafdcc157b12fa4729418467284&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "file-example_PDF_1MB.pdf",
            "readingTime": "1h 0 mins",
            "_id": "68fb1fbb6462fbc388c74bae"
          },
          {
            "chapterNumber": 4,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter4.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=704f5216dfa804ca49532f30cd67bce2d36debfed880e011225d115c6abd8ec9&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "file-example_PDF_500_kB.pdf",
            "readingTime": "10 mins",
            "_id": "68fb1fbb6462fbc388c74baf"
          },
          {
            "chapterNumber": 5,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter5.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=a42c690b97fcf7c91f8cfb8750b30c9d845f091125d6b2cb4288edec4522f919&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "file-sample_150kB.pdf",
            "readingTime": "8 mins",
            "_id": "68fb1fbb6462fbc388c74bb0"
          },
          {
            "chapterNumber": 6,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter6.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=7527c001b7aeb8aa4de29bcafcc98aab89fd7fb1771140407bda0858747c85fb&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "Flipkart BBD'24-Mobiles DealSheet_Final.pdf",
            "readingTime": "36 mins",
            "_id": "68fb1fbb6462fbc388c74bb1"
          },
          {
            "chapterNumber": 7,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter7.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=aafffbaba66721224df81c2b825a26a9603636d241d7780471152b8708de2f85&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "gorkymother.pdf",
            "readingTime": "33h 36 mins",
            "_id": "68fb1fbb6462fbc388c74bb2"
          },
          {
            "chapterNumber": 8,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter8.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=3974aa6a801156c3add54e0896b3ae4559a8683738401ba4a0a8824ad90349fe&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "Flipkart BBD'24-Mobiles DealSheet_Final.pdf",
            "readingTime": "36 mins",
            "_id": "68fb1fbb6462fbc388c74bb3"
          },
          {
            "chapterNumber": 9,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter9.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=410c543cb32eb2a8fafbb780c2a5654f5d8dbb7bf0fac5a29e15c67f8819ecec&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "file-example_PDF_1MB.pdf",
            "readingTime": "1h 0 mins",
            "_id": "68fb1fbb6462fbc388c74bb4"
          },
          {
            "chapterNumber": 10,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68fb1fb56462fbc388c74ba5-chapter10.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=ac3c2d0cc6f352d5492260c06e06b50b372abc61f983ca27c87ae556d825ffe7&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "file-example_PDF_500_kB.pdf",
            "readingTime": "10 mins",
            "_id": "68fb1fbb6462fbc388c74bb5"
          }
        ],
        "userActivityData": {
          "likes": 0,
          "reads": 1
        }
      },
      {
        "title": "Demon Slayer ",
        "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68f9db827b31ffccda556787-novel.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=46c44bdfc075fa4f204a28c2ba23d183360c1cfdda3ac970d0f2654e404fbb9f&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "novelCategory": {
          "novelCategoryName": "Entertainment ",
          "novelCategoryID": "68f3371a1f39eb821e0d6d8a"
        },
        "startDateTime": "2025-10-23T19:28:00.000Z",
        "comingSoon": false,
        "totalChapters": 2,
        "novelLanguage": {
          "languageName": "English",
          "languageID": "68413bdfe7181f45a6050e9e"
        },
        "novelStatus": "Active",
        "novelID": "68f9db827b31ffccda556787",
        "chapters": [
          {
            "chapterNumber": 1,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68f9db827b31ffccda556787-chapter1.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=16dbb614e0211fe0f5fd1cb3b061582e755ae1709019a7d3172345bdd751494e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "file-example.pdf",
            "readingTime": "10 mins",
            "_id": "68f9db887b31ffccda55678e"
          },
          {
            "chapterNumber": 2,
            "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68f9db827b31ffccda556787-chapter2.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T050803Z&X-Amz-Expires=120&X-Amz-Signature=18bb50b63c0699434485f6e2ca345bed6e8c6d7485d73b7edf09b6306623944b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "fileName": "file-example.pdf",
            "readingTime": "10 mins",
            "_id": "68fa348cb7bf39e141349e53"
          }
        ],
        "userActivityData": {
          "likes": 0,
          "reads": 2
        }
      }
    ],
    "pagination": {
      "totalRecords": 2,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Novels Based On Status

GET /novels/filter/active
Authorization: Bearer <token>
Content-Type: application/json

Path parameters:

Query parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "novels details fetched successfully",
  "novels": {
    "novelsData": [
      {
        "categoryName": "Fantasy",
        "novelCategoryID": "68f8d4d26f80562c7ceda5ce",
        "novels": [
          {
            "title": "China",
            "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68fb288f6462fbc388c7515b-novel.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T051752Z&X-Amz-Expires=120&X-Amz-Signature=11734823ddc3e4a3338e38e69c9e3c4d8595303df512c5827f258cb1d66c45d2&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "startDateTime": "2025-10-24T12:49:00.000Z",
            "novelID": "68fb288f6462fbc388c7515b",
            "userActivityData": {
              "likes": 0,
              "reads": 1
            }
          }
        ]
      },
      {
        "categoryName": "Entertainment ",
        "novelCategoryID": "68f3371a1f39eb821e0d6d8a",
        "novels": [
          {
            "title": "Movie",
            "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68fb1fb56462fbc388c74ba5-novel.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T051752Z&X-Amz-Expires=120&X-Amz-Signature=6920f0c879a80b4504e184e8b789da2adb2d9a982f28a3e5c98773d0240a4820&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "startDateTime": "2025-10-24T12:11:00.000Z",
            "novelID": "68fb1fb56462fbc388c74ba5",
            "userActivityData": {
              "likes": 0,
              "reads": 1
            }
          }
        ]
      }
    ],
    "pagination": {
      "totalRecords": 3,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Novel By Logged User Activity

GET /novels/user/get/novelId
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Novels details fetched successfully",
  "novels": {
    "title": "Demon Slayer ",
    "coverImage": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Novels/68f9db827b31ffccda556787-novel.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T060718Z&X-Amz-Expires=120&X-Amz-Signature=d2b50510f455b7bd625abe127d641cca070419d5174a5e4ffe7e86cb2eccac19&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "novelCategory": {
      "novelCategoryName": "Entertainment ",
      "novelCategoryID": "68f3371a1f39eb821e0d6d8a"
    },
    "startDateTime": "2025-10-23T19:28:00.000Z",
    "comingSoon": false,
    "totalChapters": 2,
    "novelStatus": "Active",
    "novelID": "68f9db827b31ffccda556787",
    "chapters": [
      {
        "chapterNumber": 1,
        "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68f9db827b31ffccda556787-chapter1.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T060718Z&X-Amz-Expires=120&X-Amz-Signature=9e550f6acda878d30555f942d896ad443c74f7a98e2452044f88c7f916f3ccda&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "fileName": "file-example.pdf",
        "readingTime": "10 mins",
        "_id": "68f9db887b31ffccda55678e"
      },
      {
        "chapterNumber": 2,
        "pdfUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Chapters/68f9db827b31ffccda556787-chapter2.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T060718Z&X-Amz-Expires=120&X-Amz-Signature=ad56ece64b7f32f8b76cfd53535d4a323fb6133e36e80303d2cc842a80f2f53a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "fileName": "file-example.pdf",
        "readingTime": "10 mins",
        "_id": "68fa348cb7bf39e141349e53"
      }
    ],
    "totalTime": "0 hrs 20 mins",
    "userActivityData": {
      "user": {
        "userId": "68405f3c73c0f91e76a21b3d",
        "actions": {
          "like": false,
          "dislike": false,
          "share": false,
          "download": false,
          "read": false,
          "isBookmarked": false
        }
      },
      "likes": 0,
      "dislikes": 0,
      "shares": 0,
      "reads": 2,
      "downloads": 0,
      "bookmarks": 0
    }
  }
}

Daily Quotes

Daily Quotes By Logged User Activity

GET /dailyQuotes/user/filter/Published
Authorization: Bearer <token>
Content-Type: application/json

Query parameters:

Note: fromDate and endDate must be used together. If both are provided, the API ignores days. If only days is provided, the API filters relative to the current date.

Response:

{
  "status": 200,
  "success": true,
  "message": "Daily Quotes details fetched successfully",
  "dailyQuotes": {
    "dailyQuotes": [
      {
        "dailyQuoteReportedDetails": {
          "firstName": "Admin",
          "lastName": "Admin",
          "email": "srinivas.y@cresolinfoserv.com",
          "mobileNumber": 1234567862,
          "role": "Admin",
          "profilePic": "Eyeful-News/Test/Roles/68405f3c73c0f91e76a21b3d-profile.jpeg",
          "roleID": "68405f3c73c0f91e76a21b3d"
        },
        "mediaType": "image",
        "dailyQuoteMediaURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/DailyQuotes/68ff01e85f0c8e50a22bc7d5-dailyQuote.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T062511Z&X-Amz-Expires=120&X-Amz-Signature=704f15f102fe3ab079312c2f32deeb854af826b1dbc7e038f6a0e781200b872d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "isDateScheduled": true,
        "scheduledDate": "2025-10-27T10:53:00.000Z",
        "dailyQuotePublishDate": "2025-10-27T00:00:00.000Z",
        "dailyQuoteLanguage": {
          "languageName": "తెలుగు",
          "languageID": "68468543c65a2f4251049d74"
        },
        "dailyQuoteStatus": "Published",
        "dailyQuoteID": "68ff01e85f0c8e50a22bc7d5",
        "createdAt": "2025-10-27T05:23:52.216Z",
        "updatedAt": "2025-10-27T05:23:54.991Z",
        "userActivityData": {
          "user": {
            "userId": "68405f3c73c0f91e76a21b3d",
            "actions": {
              "like": false,
              "dislike": false,
              "share": false,
              "download": false,
              "read": false,
              "isBookmarked": false
            }
          },
          "likes": 1,
          "dislikes": 0,
          "shares": 0,
          "reads": 0,
          "downloads": 0,
          "bookmarks": 0
        },
        "totalComments": 1
      },
      {
        "dailyQuoteReportedDetails": {
          "firstName": "Admin",
          "lastName": "Admin",
          "email": "srinivas.y@cresolinfoserv.com",
          "mobileNumber": 1234567862,
          "role": "Admin",
          "profilePic": "Eyeful-News/Test/Roles/68405f3c73c0f91e76a21b3d-profile.jpeg",
          "roleID": "68405f3c73c0f91e76a21b3d"
        },
        "mediaType": "image",
        "dailyQuoteMediaURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/DailyQuotes/68fe1619e6f0c33a354f67aa-dailyQuote.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T062511Z&X-Amz-Expires=120&X-Amz-Signature=d8650e711e1f388cc64f20edeecfc450444d3c3eb880719f60a9f68eb0c5da87&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "isDateScheduled": true,
        "scheduledDate": "2025-10-26T18:07:00.000Z",
        "dailyQuotePublishDate": "2025-10-26T00:00:00.000Z",
        "dailyQuoteLanguage": {
          "languageName": "English",
          "languageID": "68413bdfe7181f45a6050e9e"
        },
        "dailyQuoteStatus": "Published",
        "dailyQuoteID": "68fe1619e6f0c33a354f67aa",
        "createdAt": "2025-10-26T12:37:45.433Z",
        "updatedAt": "2025-10-26T12:37:48.214Z",
        "userActivityData": {
          "user": {
            "userId": "68405f3c73c0f91e76a21b3d",
            "actions": {
              "like": false,
              "dislike": false,
              "share": false,
              "download": false,
              "read": false,
              "isBookmarked": false
            }
          },
          "likes": 1,
          "dislikes": 0,
          "shares": 0,
          "reads": 0,
          "downloads": 0,
          "bookmarks": 0
        },
        "totalComments": 1
      }
    ],
    "pagination": {
      "totalRecords": 2,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Single Daily Quote By DailyQuote ID

GET /dailyQuotes/get/dailyQuoteID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Daily Quotes details fetched successfully",
  "dailyQuotes": {
    "dailyQuoteReportedDetails": {
      "firstName": "Admin",
      "lastName": "Admin",
      "email": "srinivas.y@cresolinfoserv.com",
      "mobileNumber": 1234567862,
      "role": "Admin",
      "profilePic": "Eyeful-News/Test/Roles/68405f3c73c0f91e76a21b3d-profile.jpeg",
      "roleID": "68405f3c73c0f91e76a21b3d"
    },
    "mediaType": "image",
    "dailyQuoteMediaURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/DailyQuotes/68fe1607e6f0c33a354f6791-dailyQuote.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T063251Z&X-Amz-Expires=120&X-Amz-Signature=b6ab1bd381e5f781f5931d999370868ec3eb52440af25952e3f899331ea24bf4&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "isDateScheduled": true,
    "scheduledDate": "2025-10-26T18:07:00.000Z",
    "dailyQuotePublishDate": "2025-10-26T00:00:00.000Z",
    "dailyQuoteLanguage": {
      "languageName": "తెలుగు",
      "languageID": "68468543c65a2f4251049d74"
    },
    "dailyQuoteStatus": "Published",
    "dailyQuoteID": "68fe1607e6f0c33a354f6791",
    "userActivityData": {
      "users": [
        {
          "userId": "68fe6cc86462fbc388c77d01",
          "actions": {
            "like": true,
            "dislike": false,
            "share": false,
            "download": false,
            "read": false,
            "isBookmarked": false
          },
          "_id": "68ff0f35b876c19928c5db11"
        }
      ],
      "likes": 1,
      "dislikes": 0,
      "shares": 0,
      "downloads": 0
    },
    "comments": [
      {
        "comment": "hi",
        "likes": 0,
        "commentID": "68ff0f39b876c19928c5db8d",
        "commentedAt": "2025-10-27T06:20:41.466Z",
        "users": [],
        "user": {
          "_id": "68fe6cc86462fbc388c77d00",
          "firstName": "",
          "email": "meranna60@gmail.com",
          "roleID": "68fe6cc86462fbc388c77d01"
        },
        "replies": [
          {
            "replyID": "68ff0f43b876c19928c5dd47",
            "comment": "hye",
            "likes": 0,
            "likedUsers": [],
            "user": {
              "_id": "68fe6cc86462fbc388c77d00",
              "firstName": "",
              "email": "meranna60@gmail.com",
              "roleID": "68fe6cc86462fbc388c77d01"
            }
          }
        ]
      }
    ]
  }
}

Magazines

Single Magazine By Magazine By ID

GET /magazines/get/magazineID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "magazine details fetched successfully",
  "magazines": {
    "name": "Dmart",
    "magazinePdfURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/MagazinePDFs/68fb14f86462fbc388c74511-magazine.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064249Z&X-Amz-Expires=120&X-Amz-Signature=a35ffa58bda7b9bfd2a0c38d1ada3b531ede0c5f426b0bdb2f210c3b9724dbf0&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "startDate": "2025-10-31T00:00:00.000Z",
    "expiryDate": "2025-11-01T00:00:00.000Z",
    "magazineLanguage": {
      "languageName": "English",
      "languageID": "68413bdfe7181f45a6050e9e"
    },
    "magazineStatus": "Active",
    "magazineID": "68fb14f86462fbc388c74511",
    "magazine": [
      {
        "imageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Magazines/68fb14f86462fbc388c74511/68fb14f86462fbc388c74511-page0.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064249Z&X-Amz-Expires=120&X-Amz-Signature=cec5f852f4602eea84c9c5a4ea56b56968256b89f3f9e55498f8f01bb1927bd7&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
      },
      {
        "imageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Magazines/68fb14f86462fbc388c74511/68fb14f86462fbc388c74511-page1.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064249Z&X-Amz-Expires=120&X-Amz-Signature=d133674feb5f73e8e144d2a8d19287faa91a8d2971f75e34f3ce9465f7dba6d2&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
      },
      {
        "imageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Magazines/68fb14f86462fbc388c74511/68fb14f86462fbc388c74511-page2.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064249Z&X-Amz-Expires=120&X-Amz-Signature=6126137fd0ca6c5cd7e516fb8de65d388f3ba5c04559f5b67b12970379809543&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
      }
    ],
    "updatedAt": "2025-10-24T05:56:12.486Z"
  }
}

Magazines Based on Status

GET /magazines/filter/active
Authorization: Bearer <token>
Content-Type: application/json

Query Parameters:

Response:

{
  "status": 200,
  "success": true,
  "message": "magazines details fetched successfully",
  "magazines": {
    "magazinesData": [
      {
        "name": "Amazon",
        "magazinePdfURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/MagazinePDFs/68fc7b0e0b3201b605c9a68c-magazine.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064440Z&X-Amz-Expires=120&X-Amz-Signature=1529344306b74e81d905d1cecc64a201bb38c658cb2a9398e009491321a091ec&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "startDate": "2025-10-25T00:00:00.000Z",
        "expiryDate": "2025-10-27T00:00:00.000Z",
        "magazineLanguage": {
          "languageName": "తెలుగు",
          "languageID": "68468543c65a2f4251049d74"
        },
        "magazineStatus": "Active",
        "magazineID": "68fc7b0e0b3201b605c9a68c",
        "magazine": [
          {
            "imageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Magazines/68fc7b0e0b3201b605c9a68c/68fc7b0e0b3201b605c9a68c-page7.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064440Z&X-Amz-Expires=120&X-Amz-Signature=d6a4f2bad68657fcddcc379bd7b1d89480d3ef04e6320630c8fd44b71c84526e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "_id": "68fc7b400b3201b605c9a697"
          }
        ],
        "updatedAt": "2025-10-25T07:24:48.711Z",
        "offerAvailableDays": 2
      },
      {
        "name": "Dmart",
        "magazinePdfURL": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/MagazinePDFs/68fb14f86462fbc388c74511-magazine.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064440Z&X-Amz-Expires=120&X-Amz-Signature=99c0ebd3200e17656db0478e245871db168d59f867c12d70e89113c389dc8d46&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "startDate": "2025-10-31T00:00:00.000Z",
        "expiryDate": "2025-11-01T00:00:00.000Z",
        "magazineLanguage": {
          "languageName": "English",
          "languageID": "68413bdfe7181f45a6050e9e"
        },
        "magazineStatus": "Active",
        "magazineID": "68fb14f86462fbc388c74511",
        "magazine": [
          {
            "imageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Magazines/68fb14f86462fbc388c74511/68fb14f86462fbc388c74511-page0.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064440Z&X-Amz-Expires=120&X-Amz-Signature=39922f619e66d03c89c47e421577bdf43237cf3e74d1e43e245138e352e562c7&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "_id": "68fb14fc6462fbc388c74515"
          },

          {
            "imageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/Magazines/68fb14f86462fbc388c74511/68fb14f86462fbc388c74511-page11.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T064440Z&X-Amz-Expires=120&X-Amz-Signature=ff2b92d76cab95b5368b9a2d8a0a9f9573ecc9251c93a0ed8a34675e1701779a&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
            "_id": "68fb14fc6462fbc388c74520"
          }
        ],
        "updatedAt": "2025-10-24T05:56:12.486Z",
        "offerAvailableDays": 1
      }
    ],
    "pagination": {
      "totalRecords": 4,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

🆕 Comments and Replies

Add Comment to Content By ID

contentID means PostId or ShortId or QuoteId

userId means roleID

contentType is means Short or Post or Quote

POST /content/comment/add
Authorization: Bearer <token>
Content-Type: application/json

{
    "contentType": "Short",
    "userID": "688c667f0edef7f9d72445ee",
    "contentID": "68888dc25de6796dd4d49dec",
    "comment": "this is not fare"
}

Response:

{
  "status": 200,
  "success": true,
  "message": "Comment created successfully",
  "commentID": "69004f906f2fa1d9f717146c"
}

Add Replies to Comment ID

userID is means roleId

POST /content/comment/reply/CommentID
Authorization: Bearer <token>
Content-Type: application/json


{
  "userID": "688211fa98c278b1f37c7128",
  "comment": "This is a hi"
}

Response:

{
  "status": 200,
  "success": true,
  "message": "Reply to Comment created successfully",
  "replyID": "6900506b6f2fa1d9f7171470"
}

Main Comment By commentId

PUT /content/comment/update/commentId
Authorization: Bearer <token>
Content-Type: application/json

{
     "newComment": "bye"
}

Response:

{
  "status": 200,
  "success": true,
  "message": "Comment details updated successfully."
}

Update Reply Comment By commentId

PUT /content/comment/reply/update/commentId?replyID=(replyId)

Authorization: Bearer <token>
Content-Type: application/json

{
     "newReply": "bye"
}

Response:

{
  "status": 200,
  "success": true,
  "message": "Reply Comment details updated successfully."
}

Main Comment By commentId

DELETE /content/comment/delete/commentId

Authorization: Bearer <token>
Content-Type: application/json

{
  "status": 200,

  "success": true,
  "message": "Comment successfully.",
  "commentID": "69004f906f2fa1d9f717146c"
}

Reply Comment By commentId

DELETE /content/comment/delete/replyCommit/commentId?replyID=(replyId)

Authorization: Bearer <token>
Content-Type: application/json

{
  "status": 200,
  "success": true,
  "message": "Reply Comment successfully."
}

User Activity

Create User Activity

contentID means PostId or ShortId or QuoteId

action is read or like and dislike and download or Job

userId means roleID

POST /activity/action
Authorization: Bearer <token>
Content-Type: application/json

{
    "contentID": "jobID",
    "userId": "68f337701f39eb821e0d6dbe",
    "contentType": "Job",
    "action": "read"
}


Response:

{
  "status": 200,
  "success": true,
  "message": "activity created successfully"
}

Bookmarks

Create or Update Bookmark

contentID means PostId or ShortId or QuoteId

action is read or like and dislike and download or Job

userId means roleID

POST /bookmark/add
Authorization: Bearer <token>
Content-Type: application/json

{
    "contentType": "Post",
    "contentID": "6867c5705f6c44e188f13517",
    "userId": "68553813130e2bd8b43f8f70"
}


Response:

{
  "success": true,
  "message": "Bookmark created successfully",
  "added": true,
  "bookmark": {
    "contentType": "Post",
    "contentID": "6867c5705f6c44e188f13517",
    "userId": "68553813130e2bd8b43f8f70",
    "_id": "68ff400e1c0ffff6a79c6de1",
    "createdAt": "2025-10-27T09:49:02.247Z",
    "updatedAt": "2025-10-27T09:49:02.247Z"
  }
}

Bookmarks By UserID

UserID means roleId

GET /bookmark/get/roleId
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Bookmarks details fetched successfully",
  "bookmarks": [
    {
      "_id": "68ff400e1c0ffff6a79c6de1",
      "contentType": "Post",
      "contentID": "6867c5705f6c44e188f13517",
      "userId": "68553813130e2bd8b43f8f70",
      "createdAt": "2025-10-27T09:49:02.247Z",
      "updatedAt": "2025-10-27T09:49:02.247Z"
    }
  ]
}

languages

Single language By language ID

GET /language/get/languageID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "language details fetched successfully",
  "languageData": {
    "_id": "68468543c65a2f4251049d73",
    "languageName": "తెలుగు",
    "languageStatus": "Active",
    "languageID": "68468543c65a2f4251049d74",
    "createdAt": "2025-06-09T06:54:59.700Z",
    "updatedAt": "2025-10-24T09:00:57.384Z",
    "nativeName": "ఆ"
  }
}

Get Active languages

Query parameters

GET /language/filter/Active
Authorization: Bearer <token>
Content-Type: application/json


Response:

{
  "status": 200,
  "success": true,
  "message": "Languages details fetched successfully",
  "languageData": {
    "activeLanguages": [
      {
        "_id": "68468543c65a2f4251049d73",
        "languageName": "తెలుగు",
        "languageStatus": "Active",
        "languageID": "68468543c65a2f4251049d74",
        "createdAt": "2025-06-09T06:54:59.700Z",
        "updatedAt": "2025-10-24T09:00:57.384Z",
        "nativeName": "ఆ"
      },
      {
        "_id": "684683acc65a2f4251049c67",
        "languageName": "Slovakia",
        "languageStatus": "Active",
        "languageID": "684683acc65a2f4251049c68",
        "createdAt": "2025-06-09T06:48:12.350Z",
        "updatedAt": "2025-10-24T09:01:02.090Z",
        "nativeName": "Aa"
      },
      {
        "_id": "68413bdfe7181f45a6050e9d",
        "languageName": "English",
        "languageStatus": "Active",
        "languageID": "68413bdfe7181f45a6050e9e",
        "createdAt": "2025-06-05T06:40:31.637Z",
        "updatedAt": "2025-10-24T09:01:06.605Z",
        "nativeName": "Aa"
      }
    ]
  }
}

locations

Single Location By Location ID

GET /location/get/locationID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,

  "success": true,
  "message": "Location details fetched successfully",
  "locationData": {
    "_id": "68f754bc5478eca4f4360373",
    "locationName": "Hyderabad",
    "locationStatus": "Active",
    "locationID": "68f754bc5478eca4f4360374",
    "createdAt": "2025-10-21T09:39:08.761Z",
    "updatedAt": "2025-10-24T09:13:32.488Z"
  }
}

Get Active Locations

Query parameters

search="hyderabad"

GET /location/filter/Active
Authorization: Bearer <token>
Content-Type: application/json


Response:

{
  "status": 200,
  "success": true,
  "message": "Locations details fetched successfully",
  "locationData": {
    "locations": [
      {
        "_id": "68fefb185f0c8e50a22bc56a",
        "locationName": "Kankipadu",
        "locationStatus": "Active",
        "locationID": "68fefb185f0c8e50a22bc56b",
        "createdAt": "2025-10-27T04:54:48.614Z",
        "updatedAt": "2025-10-27T04:54:48.614Z"
      },
      {
        "_id": "68fb0c156462fbc388c73ddb",
        "locationName": "Erode Town",
        "locationStatus": "Active",
        "locationID": "68fb0c156462fbc388c73ddc",
        "createdAt": "2025-10-24T05:18:13.720Z",
        "updatedAt": "2025-10-24T09:12:33.816Z"
      }
    ]
  }
}

🆕 jobs

Single Job by Job ID

GET /jobs/get/jobID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "Job details fetched successfully",
  "Jobs": {
    "companyImageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/DailyQuotes/68f9d30b7b31ffccda5564de-dailyQuote.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T083947Z&X-Amz-Expires=120&X-Amz-Signature=aa15c365752ac8196bd84859d2a0693cf3c15bd2b2813ce612a92e436d90e97d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
    "jobTitle": "Fast and Furious",
    "location": "Worldwide",
    "numberOfOpenings": 4,
    "jobType": ["Hybrid Job", "Part Time"],
    "description": "భారతీయ అంతరిక్ష పరిశోధనా సంస్థ (ISRO) ప్రస్తుతం అనేక శక్తివంతమైన ఉపగ్రహాలను ఆకాశంలో ప్రవేశపెట్టింది. ఈ ఉపగ్రహాలు భూ పరిశీలన, నావిగేషన్, వాతావరణ పరిశీలన, సూర్య పరిశీలన వంటి అనేక ముఖ్యమైన పనులను నిర్వహిస్తున్నాయి.",
    "hyperlink": "https://www.eyefulnews.com",
    "expiryDate": "2025-10-30T00:00:00.000Z",
    "jobStatus": "Active",
    "experience": "4",
    "softwareProficiency": [
      "A racing professional competes in motorsport events",
      "driving high-performance vehicles. Responsibilities include vehicle testing",
      "include vehicle testing",
      "strategy planning",
      "and qui"
    ],
    "technicalProficiency": [
      "A racing professional competes in  events",
      "driving high-performance vehicles. Responsibilities include vehicle testing",
      "strategy planning",
      "and teamwork with engineers to gh-performance vehicles. Responsibilities include vehicle testing",
      "strategy planning",
      "and teamwork with engineers to optimize performance. They maintain physical fitness",
      "analyze race data",
      "and adapt qui"
    ],
    "role": "www.eyefulNews.com",
    "industryType": "Automobile",
    "department": "F1",
    "education": ["no edu"],
    "jobID": "6849c5683ba402130f71bfb7",
    "createdAt": "2025-06-11T18:05:28.745Z",
    "readCounts": 0,
    "userActivityData": {
      "user": {
        "userId": "68405f3c73c0f91e76a21b3d",
        "actions": {
          "like": false,
          "dislike": false,
          "share": false,
          "download": false,
          "read": false,
          "isBookmarked": false
        }
      },
      "likes": 0,
      "dislikes": 0,
      "shares": 0,
      "downloads": 0,
      "bookmarks": 0
    }
  }
}

GET ALL Jobs

Query parameters

days=7

GET /jobs/filter/active
Authorization: Bearer <token>
Content-Type: application/json



Response:

{
  "status": 200,
  "success": true,
  "message": "jobs details fetched successfully",
  "jobs": {
    "jobs": [
      {
        "companyImageUrl": "https://eyefylnews.s3.ap-south-1.amazonaws.com/Eyeful-News/Test/DailyQuotes/68f9d30b7b31ffccda5564de-dailyQuote.jpeg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA2IDKIZHC5X3OL3UQ%2F20251027%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T084103Z&X-Amz-Expires=120&X-Amz-Signature=ee162a3296176c409ae8400b4e9d5cbfb7c3b7c86f2eaa99af100309b204e367&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
        "jobTitle": "Fast and Furious",
        "location": "Worldwide",
        "numberOfOpenings": 4,
        "jobType": ["Hybrid Job", "Part Time"],
        "expiryDate": "2025-10-30T00:00:00.000Z",
        "role": "www.eyefulnews.com",
        "jobID": "6849c5683ba402130f71bfb7",
        "createdAt": "2025-06-11T18:05:28.745Z",
        "readCounts": 0
      }
    ],
    "pagination": {
      "totalRecords": 1,
      "totalPages": 1,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Upload Company Image By Job ID

PUT /jobs/upload/jobID
Authorization: Bearer <token>
Content-Type: application/json
{
    companyImage:""
}

Response:

{
  "status": 200,
  "success": true,
  "message": "Job delete successfully"
}

Translate words

Single Translate word By TranslateID

GET /translate/get/translateID
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "status": 200,
  "success": true,
  "message": "translate word details fetched successfully",
  "translateData": {
    "name": "Enter your email",
    "data": {
      "english": "Enter your email",
      "telugu": "మీ ఇమెయిల్ నమోదు చేయండి",
      "slovakiaWord": "Zadajte svoj e-mail",
      "_id": "68e74d6f242bcd0d46c34cf6"
    },
    "translateStatus": "Active",
    "translateID": "68e74d6f242bcd0d46c34cf7"
  }
}

Translate words

GET /translate/get
Authorization: Bearer <token>
Content-Type: application/json

Response:

{
  "success": true,
  "message": "translate words details fetched successfully",
  "translateData": {
    "translateData": [
      {
        "name": "No jobs found",
        "data": {
          "english": "No jobs found",
          "telugu": "ఉద్యోగాలు కనబడలేదు",
          "slovakiaWord": "Nenašli sa žiadne pracovné miesta",
          "_id": "68f9f8e6811733c718214b22"
        },
        "translateStatus": "Active",
        "translateID": "68f9f8e6811733c718214b23"
      },
      {
        "name": "No posts found",
        "data": {
          "english": "No posts found",
          "telugu": "పోస్టులు కనబడలేదు",
          "slovakiaWord": "Nenašli sa žiadne príspevky",
          "_id": "68f8f2246d46ee74e7708bdf"
        },
        "translateStatus": "Active",
        "translateID": "68f8f2246d46ee74e7708be0"
      }
    ],
    "pagination": {
      "totalRecords": 90,
      "totalPages": 6,
      "currentPage": 1,
      "pageSize": 15
    }
  }
}

Translate words by Name wise

Query parameters

telugu=true slovakiaWord=true english=true

GET /translate/getByNameWise?slovakiaWord=true
Authorization: Bearer <token>
Content-Type: application/json


Response:

{
  "status": 200,
  "success": true,
  "message": "translate words details fetched successfully",
  "translateData": {
    "No jobs found": "ఉద్యోగాలు కనబడలేదు",
    "No posts found": "పోస్టులు కనబడలేదు",
    "No daily quotes found": "రోజువారీ కోట్స్ కనబడలేదు",
    "No novels found": "నవలలు కనిపించలేదు",
    "No short videos found": "చిన్న వీడియోలు కనిపించలేదు",
    "No offers found": "ఆఫర్లు ఏవీ లభించలేదు",
    "Re-Enter Password": "మళ్లీ పాస్‌వర్డ్ నమోదు చేయండి",
    "Enter OTP": "OTP నమోదు చేయండి",
    "Enter you email and verify your mail": "మీ ఇమెయిల్ నమోదు చేసి దాన్ని ధృవీకరించండి"
  }
}