README
Introduction
Welcome to API-BASKETBALL! You can use our API to access all API endpoints, which can get information about basketball Leagues & Cups.
We cover +380 leagues & cups with livescore, standings, pre-matches odds, statistics and more…
Full Documentation
Consult our documentation to get the best out of the API : https://api-sports.io/documentation/basketball/v1
ChangeLog
To find out about the latest updates, new competitions etc… https://headwayapp.co/api-sports-updates
Servers availability
As the availability of our APIs is essential for us and our users, we make every effort to ensure that the service is available to the maximum and with a low latency.
You can check the availability of our APIs on this link: https://api-sports.checklyhq.com
Authentication
We uses API keys to allow access to the API. You can register a new API key in rapidapi.
Our API expects for the API key to be included in all API requests to the server in a header that looks like the following:
fetch("https://api-basketball.p.rapidapi.com/{endpoint}", {
"method": "GET",
"headers": {
"x-rapidapi-host": "https://api-basketball.p.rapidapi.com",
"x-rapidapi-key": "XxXxXxXxXxXxXxXxXxXxXxXx"
}
});
> Make sure to replace XxXxXxXxXxXxXxXxXxXxXxXx
with your API key.
Requests Headers & CORS
The API is configured to work only with GET requests and allows only the headers listed below:
x-rapidapi-host
x-rapidapi-key
If you make non-GET requests or add headers that are not in the list, you will receive an error from the API.
Some frameworks (especially in JS, nodeJS…) automatically add extra headers, you have to make sure to remove them in order to get a response from the API.
Architecture
RAPIDAPI Account
All information related to your subscription are available on the rapidApi developer dashboard.
The RapidAPI developer dashboard is where you can see all of your apps, locate API keys, view analytics, and manage billing settings.
To access the dashboard, simply login to RapidAPI and select ‘My Apps’ in the top-right menu. Alternatively, you can head directly to https://rapidapi.com/developer/dashboard.
In the main dashboard, you will see account-wide analytics and account information. To get more detailed information, you can select tabs on the left-hand side of the screen.
App Specific Analytics
Using the RapidAPI dashboard, you can also view analytics specific to each app in your account. To do so, switch over to the ‘Analytics’ tab of your application in the dashboard.
On the top of the page, you’ll be able to see a chart with all the calls being made to all the APIs your app is connected to. You’ll also be able to see a log with all the request data. You are also able to filter these analytics to only show certain APIs within the app.
In each graph, you can view the following metrics:
API Calls
: how many requests are being madeError rates
: how many requests are error someLatency
: how long (on average) requests take to execute
You may change the time period you’re looking at by clicking the calendar icon and choosing a time range.
Headers sent as response
When consuming our API, you will always receive the following headers appended to the response:
server
: The current version of the API proxy used by RapidAPI.x-ratelimit-requests-limit
: The number of requests the plan you are currently subscribed to allows you to make, before incurring overages.x-ratelimit-requests-remaining
: The number of requests remaining before you reach the limit of requests your application is allowed to make, before experiencing overage charges.X-RapidAPI-Proxy-Response
: This header is set to true when the RapidAPI proxy generates the response, (i.e. the response is not generated from our servers)