Handball API

The Highlightly Handball API provides real time handball data including live scores, video highlights, standings, head to head data and last five games.

Coverage spans 180+ leagues across 35+ countries, among them the EHF Champions League, World Championship, European Championship, Olympic Games, Bundesliga, Starligue, Liga ASOBAL and women's competitions.

Base URL

handball.highlightly.net

Endpoints

18

Format

JSON only

Version

6.1.4

Also available with an All Sports API subscription at sports.highlightly.net/handball. See base URLs.

Where to start

Read Authentication first, since every request needs an API key. Pagination and limits covers paging and how your plan affects results.

If you want	Start at
Goals, saves and match recaps	Highlights
Schedules and live scores by half	Matches
League and group tables	Standings
A team's record split home and away	Team statistics

Finding a league to query

Matches, highlights, odds and standings are filtered by league. Start from countries to find the code for a territory, then leagues to get the leagueId and the seasons it has data for.

Those two values unlock standings, and leagueId alone filters matches, highlights and odds.

Base URLs

Handball data is available two ways. A Handball API subscription covers handball alone. An All Sports API subscription covers handball and all other Highlightly sports under one key. Either one can be bought directly from Highlightly or through RapidAPI, which gives four base URLs.

Subscription	Platform	Base URL
Handball API	Highlightly	https://handball.highlightly.net
Handball API	RapidAPI	https://handball-highlights-api.p.rapidapi.com
All Sports API	Highlightly	https://sports.highlightly.net/handball
All Sports API	RapidAPI	https://sport-highlights-api.p.rapidapi.com/handball

Every endpoint in this reference is available on all four. On Highlightly, one API key works for every product, and the data returned depends on your subscription to that product. On RapidAPI, each product is separate and needs its own API key.

To call an endpoint, append its path to your base URL. /matches becomes https://handball.highlightly.net/matches with a Handball API subscription and https://sports.highlightly.net/handball/matches with an All Sports API subscription. Parameters, responses and refresh intervals are the same on both, and every endpoint page shows both routes.

Your plan affects the data retrieved. On the Basic and Free plans some endpoints return fewer results and some are not available, with either subscription. See Pagination and limits.

What changes with an All Sports API subscription

The headers have the same names on every base URL. x-rapidapi-key is sent with every request, and x-rapidapi-host is sent only when calling through RapidAPI. What changes is the path and the host header, and on RapidAPI the key.

	Handball API	All Sports API
Path	/matches	/handball/matches
x-rapidapi-key on Highlightly	Your Highlightly API key	Your Highlightly API key
x-rapidapi-key on RapidAPI	Your Handball API key	Your All Sports API key
x-rapidapi-host	handball-highlights-api.p.rapidapi.com	sport-highlights-api.p.rapidapi.com

On Highlightly, the same API key works on handball.highlightly.net and sports.highlightly.net, and the data returned depends on your subscription to each product. On RapidAPI, the Handball API and the All Sports API are separate products, so each needs its own API key. One All Sports API quota covers every sport you call. See All Sports authentication.

Highlightly or RapidAPI

Both platforms give you analytics, billing settings and key management. RapidAPI does not offer custom plans or long term plan discounts.

Create an account at Highlightly or through RapidAPI. Plans and limits are listed on the Handball API page and the All Sports API page.

OpenAPI specification

Import the OpenAPI 3.0 document into Postman or Insomnia, or generate a client from it.

Download docs.json

Support

For feature requests, questions, private plans or business enquiries, contact [email protected]. You can also start a discussion or send a private message through RapidAPI.