Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nextsportsapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Rate limits depend on your plan and product access. Every response can include usage headers so your application can slow down before it is blocked.

​
Response headers

HeaderDescription
X-RateLimit-LimitMaximum requests allowed in the current rolling window.
X-RateLimit-RemainingRequests remaining in the current rolling window.
X-RateLimit-ResetUnix timestamp when the current rolling window resets.
X-Quota-LimitDaily request quota for the API key or project.
X-Quota-RemainingDaily quota remaining.
Data typeRecommended pattern
Timezones, countries, seasonsCache for days or longer.
Leagues and teamsRefresh daily unless your product needs faster discovery.
StandingsRefresh hourly during active competition periods.
Fixtures before matchdayRefresh daily or a few times per day.
Live fixturesPoll more frequently only while matches are live.

​
Handling 429

When you receive 429 Too Many Requests, pause requests until the reset time and retry with backoff. 
{
  "get": "football/fixtures",
  "parameters": {},
  "errors": [
    {
      "code": "rate_limit.exceeded",
      "message": "The request limit for this API key has been reached."
    }
  ],
  "results": 0,
  "paging": {
    "current": 1,
    "total": 1
  },
  "response": []
}
Last modified on May 19, 2026