Season Averages

Retrieve season averages for NBA players.

Get Season Averages

Use this endpoint to retrieve season averages for NBA players.

import { Time4BoostAPI } from "@time4boost/sdk";

const api = new Time4BoostAPI({ apiKey: "YOUR_API_KEY" });
const averages = await api.nba.getSeasonAverages({ season: 2023, player_ids: [246] });

The above command returns JSON structured like this:

{
  "data": [
    {
      "player_id": 246,
      "season": 2023,
      "games_played": 63,
      "minutes": 32.54,
      "points": 31.25,
      "rebounds": 11.87,
      "assists": 5.71,
      "steals": 0.76,
      "blocks": 0.81,
      "turnovers": 3.89,
      "fg_pct": 0.573,
      "fg3_pct": 0.269,
      "ft_pct": 0.661,
      "player": {
        "id": 246,
        "first_name": "Giannis",
        "last_name": "Antetokounmpo"
      }
    }
  ]
}

HTTP Request

GET https://api.time4boost.com/v1/season-averages

Query Parameters

Parameter	Required	Description
season	true	The season year (e.g., 2023 for the 2023-2024 season)
player_ids	false	Comma-separated list of player IDs to filter the results

Error Responses

The API uses the following error codes:

Error Code	Meaning
400	Bad Request -- Your request is invalid.
401	Unauthorized -- Your API key is wrong.
403	Forbidden -- The requested resource is hidden for administrators only.
404	Not Found -- The specified resource could not be found.
429	Too Many Requests -- You're requesting too many resources! Slow down!
500	Internal Server Error -- We had a problem with our server. Try again later.

Rate Limiting

The API is rate limited to prevent abuse and ensure a fair usage for all users. The rate limits depend on your account tier:

Free tier: 30 requests per minute
ALL-STAR tier: 60 requests per minute
GOAT tier: 120 requests per minute

If you exceed the rate limit, you'll receive a 429 Too Many Requests response. The response will include headers indicating your current rate limit status:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1623423149

The X-RateLimit-Reset header contains a Unix timestamp indicating when your rate limit will reset.