πŸ₯‡Contests

The contests endpoint and how you can use it

The Digitomize API allows users to get details about programming contests. This endpoint allows you to:

All Contests

GET https://www.v2api.digitomize.com/contests

This endpoint allows you to get all the programming contests available in Digitomize

This is the response you will get when your request is successful.

The response body has a total property and a results property which is an array of objects containing the contests. It will have the following format:

{
    "total" : integer,
    "results": [
        {
            "host": string,
            "name": string,
            "vanity": string,
            "url": string,
            "startTimeUnix": timestamp,
            "duration": integer
        }
    ]
}

Specific host

GET https://www.v2api.digitomize.com/contests

This API route allows you to get all the programming contests available in Digitomize by a specific host

Query Parameters

Name
Type
Description

host

String

One of the available event hosts

This is the response you will get when your request is successful.

The response body will have the following format:

{
    "total" : integer,
    "results": [
        {
            "host": string,
            "name": string,
            "vanity": string,
            "url": string,
            "startTimeUnix": timestamp,
            "duration": integer
        }
    ]
}

The available event hosts in Digitomize include:

  • geeksforgeeks

  • codechef

  • codeforces

  • atcoder

  • codingninjas

  • leetcode

In this example, we will get programming contests by GeeksForGeeks.

The request URL is https://www.v2api.digitomize.com/contests?host=geeksforgeeks

You will get the following JSON object as a response.

{
    "total": 6,
    "results": [
        {
            "host": "geeksforgeeks",
            "name": "Bi-Wizard School Coding Tournament 22.0",
            "vanity": "bi-wizard-school-coding-tournament-220",
            "url": "https://practice.geeksforgeeks.org/contest/bi-wizard-school-coding-tournament-220",
            "startTimeUnix": 1703593800,
            "duration": 90
        },
        {
            "host": "geeksforgeeks",
            "name": "GFG Weekly Coding Contest - 135",
            "vanity": "gfg-weekly-coding-contest-135",
            "url": "https://practice.geeksforgeeks.org/contest/gfg-weekly-coding-contest-135",
            "startTimeUnix": 1704029400,
            "duration": 90
        },
        {
            "host": "geeksforgeeks",
            "name": "GFG Weekly Coding Contest - 136",
            "vanity": "gfg-weekly-coding-contest-136",
            "url": "https://practice.geeksforgeeks.org/contest/gfg-weekly-coding-contest-136",
            "startTimeUnix": 1704634200,
            "duration": 90
        },
        {
            "host": "geeksforgeeks",
            "name": "GATE CS 2024 - All India Mock 2",
            "vanity": "all-india-mock-gate-csit-ii",
            "url": "https://practice.geeksforgeeks.org/contest/all-india-mock-gate-csit-ii",
            "startTimeUnix": 1705775400,
            "duration": 1440
        },
        ...
    ]
}

Multiple hosts

GET https://www.v2api.digitomize.com/contests

This API route allows you to get all the programming contests available in Digitomize by multiple event hosts

Query Parameters

Name
Type
Description

host

String

Two or more of the available event hosts

This is the response you will get when your request is successful.

The response body will have the following format:

{
    "total" : integer,
    "results": [
        {
            "host": string,
            "name": string,
            "vanity": string,
            "url": string,
            "startTimeUnix": timestamp,
            "duration": integer
        }
    ]
}

The available event hosts in Digitomize include:

  • geeksforgeeks

  • codechef

  • codeforces

  • atcoder

  • codingninjas

  • leetcode

In this example, you will get all the programming contests hosted by GeeksForGeeks and CodeChef.

The request URL will be https://www.v2api.digitomize.com/contests?host=geeksforgeeks,codechef

You will get the following JSON object as the response:

{
    "total": 12,
    "results": [
        {
            "host": "geeksforgeeks",
            "name": "Bi-Wizard School Coding Tournament 22.0",
            "vanity": "bi-wizard-school-coding-tournament-220",
            "url": "https://practice.geeksforgeeks.org/contest/bi-wizard-school-coding-tournament-220",
            "startTimeUnix": 1703593800,
            "duration": 90
        },
        {
            "host": "codechef",
            "name": "Starters 114",
            "vanity": "start114",
            "url": "https://www.codechef.com/START114",
            "startTimeUnix": 1703687400,
            "duration": 120
        },
        {
            "host": "geeksforgeeks",
            "name": "GFG Weekly Coding Contest - 135",
            "vanity": "gfg-weekly-coding-contest-135",
            "url": "https://practice.geeksforgeeks.org/contest/gfg-weekly-coding-contest-135",
            "startTimeUnix": 1704029400,
            "duration": 90
        },
        {
            "host": "codechef",
            "name": "Starters 115",
            "vanity": "start115",
            "url": "https://www.codechef.com/START115",
            "startTimeUnix": 1704292200,
            "duration": 120
        },
        ...
    ]
}

Specific contest

GET https://www.v2api.digitomize.com/contests

This API route allows you to get a specific programming contest based on the vanity string

Query Parameters

Name
Type
Description

vanity

String

A unique string for an event

This is the response you will get when your request is successful.

The response body will have the following format:

{
    "total" : integer,
    "results": [
        {
            "host": string,
            "name": string,
            "vanity": string,
            "url": string,
            "startTimeUnix": timestamp,
            "duration": integer
        }
    ]
}

In this example, you will get details about a weekend contest on GeeksForGeeks.

The request URL will be https://www.v2api.digitomize.com/contests?vanity=weekend-contest-106

You will get the following JSON object as a response:

{
    "total": 1,
    "results": [
        {
            "host": "codingninjas",
            "name": "Weekend Contest 106",
            "vanity": "weekend-contest-106",
            "url": "https://codingninjas.com/studio/contests/weekend-contest-106",
            "startTimeUnix": 1703941200,
            "duration": 90
        }
    ]
}

Feel free to use this API. If you have any issues, you can raise it in our Discord channel.

Last updated