Highlightly

Basketball Highlights API

The Highlightly Basketball API provides real-time basketball data including live scores with quarter-by-quarter breakdowns, video highlights, team statistics,…

Data & analytics#sports--fitness

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Highlightly Basketball API provides real-time basketball data including live scores with quarter-by-quarter breakdowns, video highlights, team statistics, standings, predictions, head-to-head data, and last five games across 340+ leagues including Euroleague, ACB, BBL, LNB, Lega A, NBL, CBA, FIBA World Cup, and WNBA.

Contact

For feature requests, questions, private plans or business inquiries you can contact us at [support@highlightly.net](mailto:support@highlightly.net).

You can also contact us via RapidAPI by starting a discussion or by sending us a private message.

Integration

To start using our API services you will first need to create an account via Highlightly or RapidAPI.
Both platforms offer you the ability to view the API analytics, manage billing settings, control API keys and much more. However, there are a few differences. RapidAPI does not include custom plans nor does it provide long term plan discounts.

> Accounts are not synced across platforms.

> Please ensure that your API key is not made public to prevent potential abuse. Your API key can be managed either through Highlightly or RapidAPI.

API usage

> Highlightly API base url: https://basketball.highlightly.net

> RapidAPI API base url: https://basketball-highlights-api.p.rapidapi.com

Each API request will be considered valid only if the following headers are present:

Request HeaderValue
x-rapidapi-keyYour Highlightly or RapidAPI API Key
x-rapidapi-hostbasketball-highlights-api.p.rapidapi.com - only needed for usage through RapidAPI

These headers are mandatory when requesting API data. They are not needed when requesting other resources such as logos or images.

Each API response will contain additional headers. The following three are considered the most important for developers:

Response HeaderValue
x-ratelimit-requests-limitThis is a static value indicating the number of requests the plan you are currently subscribed to allows you to make.
x-ratelimit-requests-remainingThe number of requests remaining (from your plan) before you reach the limit of requests your application is allowed to make. When this reaches zero, you will not be able to make any requests until your daily quota is reset. You can view these limits and quotas on the pricing page of the API in the API Hub.
content-typeValue will always be application/json. XML format is not supported.

In the following sections we will guide you through all endpoints and functionalities the API has to offer.

Endpoints 19

Basketball.Countries

  • GETGet all countries/countries> Refresh interval: Once a day Retrieve a list of countries that are supported by the API. By utilising the name query parameter you can check whether a…
  • GETGet country by country code/countries/:countryCode> Refresh interval: Once a day Retrieve associated country details by specifying the country code path parameter. The path parameter should follow the ISO…

Basketball.Matches

  • GETGet all matches/matches> Refresh interval: Once a minute > Route returns only general match information. For additional match details check the matches/{matchId} route. Retrieve a…
  • GETGet match by id/matches/:idRetrieve detailed match information by specifying the match id path parameter. Certain popular leagues and their associated matches will have additional data…

Basketball.Highlights

  • GETGet all highlights/highlights> Refresh interval: Once a minute > Note: Certain highlights might be uploaded whilst the game is playing. Full game recaps tend to be uploaded anywhere from…
  • GETGet geo restrictions for highlight/highlights/geo-restrictions/:id> Refresh interval: Once an hour > Note: Endpoint is not available in the Basic/Free plan. Geo restrictions are a plague that have been around for quite a…
  • GETGet highlight by id/highlights/:idRetrieve highlight information by specifying the highlight id path parameter. > Note: Used to check whether a highlight still exists or had its information…

Basketball.Leagues

  • GETGet all leagues/leagues> Refresh interval: Multiple times a day Retrieve a list of leagues. By utilising the leagueName query parameter you can check whether a specific league…
  • GETGet league by id/leagues/:idRetrieve league information by specifying the league id path parameter. > Note: Used to check whether a league still exists or had its information updated.

Basketball.Teams

  • GETGet all teams/teamsRetrieve a list of teams that are supported by the API. By utilising the name query parameter you can check whether a specific team exists or simply retrieve…
  • GETGet team statistics/teams/statistics/:id?fromDate=2023-08-06> Refresh interval: Immediately once a match is finished. Retrieve team stats for each league and season by specifying the team's id path parameter. Requires…
  • GETGet team by team id/teams/:idRetrieve team information by specifying the team id path parameter. > Note: Used to check whether a team still exists or had its information updated.

Basketball.Bookmakers

  • GETGet all bookmakers/bookmakers> Refresh interval: Once a day Retrieve a list of supported bookmakers. There are two important parameters that are used to navigate through the pagination.…
  • GETGet bookmaker by id/bookmakers/:idRetrieve bookmaker information by specifying the bookmaker id path parameter. > Note: Used to check whether a bookmaker still exists or had its information…

Basketball.Odds

  • GETGet all odds/odds> Prematch odds refresh interval: Multiple times a day > Live odds refresh interval: Once every 10 minutes > Note: Endpoint is not available in the Basic/Free…

Basketball.Last Five Games

  • GETGet last five finished games for a specific team id/last-five-games?teamId=1635> Refresh interval: Immediately once a game is considered finished Retrieve a list of the last five finished games for a specific team. If a game was not…

Basketball.Head 2 Head

  • GETGet head 2 head games/head-2-head?teamIdOne=1635&teamIdTwo=7592Retrieve a list of the last ten head 2 head games between two teams. Compare the two teams to find out who is stronger based on their past match results.…

Basketball.Standings

  • GETGet standings/standings?leagueId=2486&season=2023> Refresh interval: Up to an hour after a match for the associated league and season is finished Retrieve standings data for a specific league, conference or…

Basketball.Statistics

  • GETGet match statistics by match id/statistics/:matchId> Refresh interval: Once every 5 minutes Retrieve match statistics data by specifying the matchId as the path parameter. Below is an example of what you can…

API details

Base URL
https://basketball.highlightly.net
https://basketball-highlights-api.p.rapidapi.com
Authentication
None declared in the description
Operations
19 operations on 19 pathsGET 19
Main resources
Basketball.Highlights 3Basketball.Teams 3Basketball.Bookmakers 2Basketball.Countries 2Basketball.Leagues 2Basketball.Matches 2Basketball.Head 2 Head 1Basketball.Last Five Games 1Basketball.Odds 1Basketball.Standings 1
Response formats
application/json
Description format
OpenAPI 3.0.0, API version 7.2.4

How to test the Basketball Highlights API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Basketball Highlights API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “Get all countries” (GET /countries), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Basketball Highlights API?

The Highlightly Basketball API provides real-time basketball data including live scores with quarter-by-quarter breakdowns, video highlights, team statistics,… It is listed under Data & analytics and has 19 endpoints.

Who publishes the Basketball Highlights API?

It is listed from Highlightly's public API description (an OpenAPI document), not published by Highlightly on Swastik Codes. Anyone who controls highlightly.net can claim the profile by adding a DNS TXT record.

What is the base URL of the Basketball Highlights API?

Its description lists 2 base URLs: https://basketball.highlightly.net, https://basketball-highlights-api.p.rapidapi.com. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the Basketball Highlights API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Basketball Highlights API have?

19 operations on 19 paths (19 GET). The largest groups are Basketball.Highlights, Basketball.Teams, Basketball.Bookmakers, Basketball.Countries.

Is forking the Basketball Highlights API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.