alfa-leetcode-api

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

The API for retrieving your LeetCode profile & Problems statistics

<img src="https://img.shields.io/badge/License-MIT-green.svg"/> <img src="https://img.shields.io/npm/v/npm.svg?logo=nodedotjs"/>

</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

Connect with me 📲