Basketball API - Preseason + Regular + All Stars + Playoffs (NBA)

1. Determine the structure of the tournament

Let's create the "NBA 2023-2024" tournament. First, you have to understand its structure.

Image 9950


Click on Wikipedia Search to find out the structure and dates !!!

Find the proper article and check the tournament structure.

Image 9951

Check the API game list.


Image 9907

We have several problems.

a) Preseason, regular season and 1st & 2nd playoff rounds have empty week.

Image 9952

b) Play-in stage has the same weeks as playoff finals. 

Image 9953

c) The All-Stars game has the same week as playoff and play-in finals

Image 9954

We will use the "by date" option to make proper stage and round mapping and fix these problems in step 3. 

2. Create Tournament

Create a League and Season if needed (if not created yet).

Image 9955

Image 9933

Create new Tournament

Image 9956


Add preseason stage (see screenshot). It is recommended to save after adding every stage.

Image 9957


Add Regular Season


Image 9958

Then All-Star Game.

Image 9959


Add Play-in stage

Image 9960

Then, create a Knockout Stage with rounds (without teams) and Save.

Image 9961

3. Create Import Configuration

Now it's time to create Import Configuration.

Image 9962


Image 9963

Select your tournament and click Next Step.

Image 9964

Remember: ⚠ "by date" has higher priority than "by week".

How plugin map games to stages and rounds:

- plugin analyzes games one by one

- first, it checks if the game is associated with any mapped time period (created with the "by date" option)

- then, check mapped weeks (if no time period is suitable)
- When comparing, the game kickoff time (GMT) is decreases by 9 hours.

Image 9965


According to the above rules, we have created a mapping structure.

Image 9966

You can also open the game list in the new tab as a reference.

Image 9967

4. Import API Data

Image 9968

5. Check for errors

Open the tournament after importing and check for errors.

As you can see on the screenshot, something is not correct in Conference Semifinals.

Image 9970

If you open the API game list, you will find an error (see screenshot).

Image 9971

To fix it, open the tournament for editing and remove this matchup.

Image 9972

Image 9973

6. Create Standings (optional)

Let's create a Standing table with Conference support.

Go to the Tournament edit page, and at the bottom, add Conferences and Divisions.

Image 9990

Then go to the Teams. Open for editing and add Conference and Division. You can also fill in additional information such as a short name, color, etc.

Image 9991

Go to the Standings >> Add New.
Select Tournament + Group and click "Select Group & Continue"

Image 9999

Use Column Builder to create table structure you want.

Image 9924

Activate Conference & Division support. 

Image 10001


Is this article helpful for you?