Merge pull request #74 from Ayushman2004/feature/contests

alfaarghya · web-flow · commit 09b59bede3ea · 2025-10-31T11:30:58.000+05:30
Added new /contests and /contests/upcoming endpoints to fetch all the contests and future contests respectively.
diff --git a/README.md b/README.md
@@ -86,6 +86,15 @@ During development, it's recommended to utilize the API locally. To do so, follo
 | _Skip & Filter & Limited Problems_ | `/problems?tags=tag1+tag2+tag3&limit=number&skip=number` | Get a list of a specified **_number_** of problems based on selected **_tags_** skipping a specified **number** of problems. | <a href="./public/demo/demo21.png" target="_blank">click here</a> |
 | _Official Solution_                | `/officialSolution?titleSlug=selected-question`          | Get Get the official solution(leetcode) for a question                                                                       | TODO                                                              |
 
+### Contests
+
+| Details                            | Endpoint                                                 | Description                                                                                                                  | Demo                                                              |
+| :--------------------------------- | :------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| _All Contests_                    | `/contests`                                                 | Get all the contests                                                                                                       | TODO |
+| _Upcoming Contests_                | `/contests/upcoming`                                             | Get the upcoming contests.                                                                                               | TODO |                  
+
+
+
 ### Discussion
 
 | Details               | Endpoint                    | Description                     |
@@ -107,6 +116,7 @@ During development, it's recommended to utilize the API locally. To do so, follo
 | [@kvqn](https://www.github.com/kvqn)               | PORT environment variable                                                        |
 | [@changchunlei](https://github.com/changchunlei)   | New Endpoints - language stats, integrated user profile, contest and discussions |
 | [@merakesh99](https://github.com/merakesh99)       | Hot reload issue solved                                                          |
+| [@Ayushman2004](https://github.com/Ayushman2004)   | Added Endpoints: all-contests, upcoming-contests                                 |
 | [@ajchili](https://github.com/ajchili)             | Skip param to fetch problems                                                     |
 | [@theinit01](https://github.com/theinit01)         | Temp fix for skip                                                                |
 | [@123xylem](https://github.com/123xylem)           | Add Descriptions and Methods to API route documentation.                         |
diff --git a/package-lock.json b/package-lock.json
diff --git a/src/Controllers/fetchContests.ts b/src/Controllers/fetchContests.ts
@@ -0,0 +1,76 @@
+import { Response } from 'express';
+
+export const fetchAllContests = async (
+    res: Response,
+    query: string
+) => {
+    try {
+        const response = await fetch('https://leetcode.com/graphql', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Referer: 'https://leetcode.com',
+            },
+            body: JSON.stringify({
+                query: query
+            }),
+        });
+
+        const result = await response.json();
+        if (!response.ok) {
+            console.error(`HTTP error! status: ${response.status}`);
+        }
+        if (result.errors) {
+            return res.send(result);
+        }
+
+        return res.json(result.data);
+    } catch (err) {
+        console.error('Error: ', err);
+        return res.send(err);
+    }
+};
+
+export const fetchUpcomingContests = async (
+    res: Response,
+    query: string
+) => {
+    try {
+        const response = await fetch('https://leetcode.com/graphql', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Referer: 'https://leetcode.com',
+            },
+            body: JSON.stringify({
+                query: query
+            }),
+        });
+
+        const result = await response.json();
+        if (!response.ok) {
+            console.error(`HTTP error! status: ${response.status}`);
+        }
+        if (result.errors) {
+            return res.send(result);
+        }
+
+        const now = Math.floor(Date.now() / 1000);
+        const allContests = result.data.allContests || [];
+
+        const upcomingContests = allContests.filter(
+            (contest: any) => contest.startTime > now
+        );
+
+
+        return res.json({
+            count: upcomingContests.length,
+            contests: upcomingContests,
+        });
+    } catch (err) {
+        console.error('Error: ', err);
+        return res.send(err);
+    }
+};
+
+
diff --git a/src/Controllers/index.ts b/src/Controllers/index.ts
@@ -4,4 +4,5 @@ export { default as fetchUserDetails } from './fetchUserDetails';
 export { default as fetchTrendingTopics } from './fetchDiscussion';
 export { default as fetchDataRawFormat } from './fetchDataRawFormat';
 export { default as handleRequest } from './handleRequest';
-export { default as fetchUserProfile } from './fetchUserProfile';
+export { default as fetchUserProfile } from './fetchUserProfile';
+export {  fetchAllContests, fetchUpcomingContests } from './fetchContests';
diff --git a/src/GQLQueries/allContests.ts b/src/GQLQueries/allContests.ts
@@ -0,0 +1,13 @@
+export const allContestQuery = `
+ query allContests {
+    allContests {
+        title
+        titleSlug
+        startTime
+        duration
+        originStartTime
+        isVirtual
+        containsPremium
+        }
+}
+`
diff --git a/src/GQLQueries/index.ts b/src/GQLQueries/index.ts
@@ -15,4 +15,5 @@ export { skillStatsQuery } from './skillStats';
 export { userQuestionProgressQuery } from './userQuestionProgress';
 export { discussTopicQuery } from './discussTopic';
 export { discussCommentsQuery } from './discussComments';
-export { userContestRankingInfoQuery } from './userContestRanking';
+export { userContestRankingInfoQuery } from './userContestRanking';
+export { allContestQuery } from './allContests';
diff --git a/src/app.ts b/src/app.ts
@@ -112,6 +112,9 @@ app.get('/officialSolution', leetcode.officialSolution);
 //get list of problems
 app.get('/problems', leetcode.problems);
 
+//get contests
+app.get('/contests', leetcode.allContests);
+app.get('/contests/upcoming', leetcode.upcomingContests);
 
 // Construct options object on all user routes.
 app.use(
diff --git a/src/leetCode.ts b/src/leetCode.ts
@@ -303,4 +303,25 @@ export const userProfileUserQuestionProgressV2_ = (req: Request, res: Response)
 export const userContestRankingInfo_ = (req: Request, res: Response) => {
   const { username } = req.params;
   controllers.handleRequest(res, gqlQueries.userContestRankingInfoQuery, { username });
-};
+};
+
+//limiting is not supported in the contests unlike problems
+export const allContests = (
+  _req: Request,
+  res: Response
+) => {
+  controllers.fetchAllContests(
+    res,
+    gqlQueries.allContestQuery
+  );
+};
+
+export const upcomingContests = (
+  _req: Request,
+  res: Response
+) => {
+  controllers.fetchUpcomingContests(
+    res,
+    gqlQueries.allContestQuery
+  );
+};
