alfa-leetcode-api

<h1 align="center">alfa-leetcode-api</h1> <div align="center">

The API for retrieving your LeetCode profile & Problems statistics

</div>

About ✨

At First, I struggled to find proper documentation for the leetcode.com/graphql. After scouring various articles about the LeetCode public API, I still couldn't find the comprehensive documentation I was looking for. Fueled by the desire to fill this gap I created alfa-leetcode-api.

alfa-leetcode-api is a custom solution born out of the need for a well-documented and detailed LeetCode API. This project is designed to provide developers with endpoints that offer insights into a user's profile, badges, solved questions, contest details, contest history, submissions, and also daily questions, selected problem, list of problems.

API URL 🌐

https://alfa-leetcode-api.onrender.com/

Run with docker 🐳

docker run -p 3000:3000 alfaarghya/alfa-leetcode-api:2.0.1

Wanna Contribute 🤔??

follow this documentation => <a href="CONTRIBUTING.md" target="_blank">CONTRIBUTING.md</a>

💡 Rate Limit

I've implemented a rate limit to prevent any potential server overload issues.

‼️ Note

During development, it's recommended to utilize the API locally. To do so, follow this documentation => <a href="CONTRIBUTING.md" target="_blank">Local Deploy</a>

Endpoints 🚀

👤User Details

Details	Endpoint	Description	Demo
Profile	`/:username`	Get details about a user's profile.	<a href="./public/demo/demo2.png" target="_blank">click here</a>
Badges	`/:username/badges`	Get the badges earned by the user.	<a href="./public/demo/demo3.png" target="_blank">click here</a>
Solved	`/:username/solved`	Get the total number of questions solved by the user.	<a href="./public/demo/demo4.png" target="_blank">click here</a>
Contest	`/:username/contest`	Get details about the user's contest participation.	<a href="./public/demo/demo5.png" target="_blank">click here</a>
Contest History	`/:username/contest/history`	Get contest history.	<a href="./public/demo/demo6.png" target="_blank">click here</a>
Submission	`/:username/submission`	Get the last 20 submissions of the user.	<a href="./public/demo/demo7.png" target="_blank">click here</a>
Limited Submission	`/:username/submission?limit=number`	Get a specified *number* of the user's last submissions.	<a href="./public/demo/demo8.png" target="_blank">click here</a>
Accepted Submission	`/:username/acSubmission`	Get the last 20 accepted submission of the user.	<a href="./public/demo/demo16.png" target="_blank">click here</a>
Limited Accepted Submission	`/:username/acSubmission?limit=7`	Get a specified *number* of the user's last accepted submission.	<a href="./public/demo/demo17.png" target="_blank">click here</a>
Calendar	`/:username/calendar`	Get the user's submission calendar.	<a href="./public/demo/demo9.png" target="_blank">click here</a>

😀 New Endpoints 🎉

Details	Endpoint	Description
Full Profile	`/userProfile/:username`	get full profile details in one call
Year Calender	`/userProfileCalendar?username=yourname&year=2024`	get your calendar details with year
Lang Stats	`/languageStats?username=yourname`	get the language stats of a user
Question Progress	`/userProfileUserQuestionProgressV2/:userSlug`	get your question progress
Skill Stats	`/skillStats/:username`	get your skill stats
User Contest Ranking	`/userContestRankingInfo/:username`	get contest ranking
Trending Discussion	`/trendingDiscuss?first=20`	get top 20 trending discussions
Discussion Topic	`/discussTopic/:topicId`	get discussion topic
Discussion Comment	`/discussComments/:topicId`	get discussion comments
Raw Daily Problem	`/dailyQuestion`	get raw daily question

❓Questions Details

Details	Endpoint	Description	Demo
Daily Problem	`/daily`	Get the daily question.	<a href="./public/demo/demo10.png" target="_blank">click here</a>
Selected Problem	`/select?titleSlug=selected-question`	Get details about a *selected-question*.	<a href="./public/demo/demo11.png" target="_blank">click here</a>
Problems	`/problems`	Get a list of 20 problems.	<a href="./public/demo/demo12.png" target="_blank">click here</a>
Limited Problems	`/problems?limit=number`	Get a list of a specified *number* of problems.	<a href="./public/demo/demo13.png" target="_blank">click here</a>
Filter Problems	`/problems?tags=tag1+tag2`	Get a list of problems based on selected *tags*.	<a href="./public/demo/demo14.png" target="_blank">click here</a>
Skip Problems	`/problems?skip=number`	Get a list of 20 problems, skipping a specified *number* of problems.	TODO
Filter & Limited Problems	`/problems?tags=tag1+tag2+tag3&limit=number`	Get a list of a specified *number* of problems based on selected *tags*.	<a href="./public/demo/demo15.png" target="_blank">click here</a>
Skip & Limited Problems	`/problems?limit=number&skip=number`	Get a list of a specified *number* of problems skipping a specified number of problems.	TODO
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.	TODO

Author ✒️

@alfaarghya

Contributor ✏️

Contributor	Contribution
@aryanpingle	AC submission
@jamesh48	TypeScript Refactoring
@kvqn	PORT environment variable
@changchunlei	New Endpoints - language stats, integrated user profile, contest and discussions
@merakesh99	Hot reload issue solved