/contest-scraper

A web scraper that provides APIs for contests on top coding Plateforms

Primary LanguageJavaScript

Coding Contests API

Welcome to the Contests API. This API provides endpoints to retrieve contest data for various Coding platforms.

plateform supports

  • codeforces
  • topcoder
  • atcoder
  • codechef
  • leetcode
  • hackerrank
  • hackerearth
  • spoj
  • kickstart
  • geeksforgeeks
  • codingninja
  • codingame

Endpoints

Get All Contests

Request

  • URL: /contests/all
  • Method: GET
  • Description: Retrieves all available contest data for different platforms.

example:

http://localhost:3000/api/v1/contests/codeforces

Get specific platform Contests

Request

  • URL: /contests/[platform_name]
  • Method: GET
  • Description: Retrieves all available contest data for specific platforms.

example:

http://localhost:3000/api/v1/contests/codeforces

http://localhost:3000/api/v1/contests/leetcode

Response

[
  {
    "id": "68efe7ce-9a5b-430f-9342-254470638807",
    "name": "Codeforces Round 912 (Div. 2)",
    "url": "https://codeforces.com/contests/1903",
    "start_time": 1701362100000,
    "end_time": 1701369300000,
    "duration": 7200,
    "type_": "Unknown",
    "in_24_hours": "No",
    "status": "BEFORE",
    "site": "codeforces"
  },
  {
    "id": "b2023729-0216-4f78-ae56-edb3e3e33fd5",
    "name": "Weekly Contest 374",
    "url": "https://leetcode.com/contest/weekly-contest-374",
    "start_time": 1701570600000,
    "end_time": 1701576000000,
    "duration": 5400,
    "type_": "Unknown",
    "in_24_hours": "No",
    "status": "BEFORE",
    "site": "leetcode"
  },
]

-------------------------------------------
start_time, end_time are in milliseconds.
duration is in seconds.
-------------------------------------------

💻 Setup

Requirements:

Installation:

  • Dependencies installation npm install
  • Run npm start or npm run dev