HandballAPI
HandballAPI offers you live scores and live results from most popular handball leagues like German Bundesliga, Spain Liga Asobal, Denmark mens Handboldligaen and France D1. We also provide livescore, results, statistics, tables and fixtures from important cups like European handball Champions League, SEHA league and EHF handball Cup. You can find livescores for international teams handball…
HandballAPI endpoints
| Method | Endpoint | Description |
|---|---|---|
| TV | ||
| GET |
getMatchTVCountries /api/tv/country/all/event/{id} |
Lists the countries and the TV channels within them that are broadcasting a specific match. |
| GET |
getTVChannelSchedule /api/tv/channel/{id}/schedule |
Retrieves the broadcast schedule for a specific TV channel. |
| GET |
getMatchTVChannelVotes /api/tv/channel/{channId}/event/{id} |
Fetches viewer voting data from a specific TV channel that is broadcasting the match. |
| GET |
getCountryTVChannels /api/tv/country/{countryCode}/channels |
Retrieves available TV channels for a specific country. |
| Media | ||
| GET |
getCountryFlagImgAPI /api/country/{code}/flag |
Fetches the flag image from the image API by country code. |
| GET |
getCountryFlag /api/img/flag/{flag} |
Fetches the PNG flag image asset corresponding to a provided country code. The response is the raw image data. |
| Placeholders | ||
| GET |
getPlaceholderManagerSvg /api/placeholder/manager.svg |
Returns a static placeholder graphic for a manager. The response is an SVG image. |
| GET |
getPlaceholderPlayerSvg /api/placeholder/player.svg |
Returns a static placeholder graphic for a player. The response is an SVG image. |
| GET |
getTeamPlaceholderImage /api/placeholder/team.svg |
Returns a static placeholder graphic for a team. The response is an SVG image. |
| GET |
getPlaceholderPlayerPng /api/placeholder/player.png |
Returns a static placeholder graphic for a player. The response is an SVG image. |
| GET |
getPlaceholderTournamentPng /api/placeholder/tournament.png |
Returns a static placeholder graphic for a tournament. The response is an SVG image. |
| GET |
getPlaceholderTournamentSvg /api/placeholder/tournament.svg |
Returns a static placeholder graphic for a tournament. The response is an SVG image. |
| GET |
getPlaceholderManagerPng /api/placeholder/manager.png |
Returns a static placeholder graphic for a manager. The response is an SVG image. |
| Calendar | ||
| GET |
getCalendarDaysWithEvents /api/calendar/season/{seasonId}/{year}/days-with-events |
Retrieves days that have events for a specific season and year. |
| Categories | ||
| GET |
getHandballMatchesByCategoryAndDate /api/handball/category/{id}/events/{day}/{month}/{year} |
Retrieves all handball matches for a specific category on a given date. |
| GET |
getCategoryImage /api/category/{categoryId}/image |
Retrieves the image/logo for a sport category. |
| Config | ||
| GET |
getAllCountries /api/countries/all |
Retrieves a list of all available countries. |
| Rankings | ||
| GET |
getTeamRankings /api/rankings/team/{teamId} |
Retrieves rankings for a specific team. |
| Search | ||
| GET |
getSearchSuggestions /api/search/suggestions/{entityType} |
Retrieves search suggestions for a specific entity type. |
| GET |
searchHandballEntities /api/handball/search/{term} |
Searches for handball teams, players, and tournaments. |
| GET |
searchByEntityType /api/search/{entityType} |
Searches for entities of a specific type. |
| GET |
searchUniqueTournaments /api/search/unique-tournaments |
Searches for unique tournaments. |
| GET |
searchAllEntities /api/search/all |
Searches across all entity types (teams, players, tournaments). |
| Matches | ||
| GET |
getHeadToHeadHistory /api/handball/match/{customId}/h2h |
Retrieves detailed head-to-head match history between the teams. |
| GET |
getHandballMatchesByDate /api/handball/matches/{day}/{month}/{year} |
Deprecated — the flat per-date feed is being retired. Assemble the day per competition instead — list categories then call /api/{sport}/category/{id}/events/{day}/{month}/{year},… |
| GET |
getMatchVotes /api/handball/match/{id}/votes |
Retrieves fan voting results for the match. |
| GET |
getMatchStatistics /api/handball/match/{id}/statistics |
Retrieves comprehensive statistical data for the handball match. |
| GET |
getHeadToHeadSummary /api/handball/match/{id}/duel |
Retrieves a summary of head-to-head statistics between the teams. |
| GET |
getMatchIncidents /api/handball/match/{id}/incidents |
Retrieves all incidents and events that occurred during the match. |
| GET |
getMatchStreaks /api/handball/match/{id}/streaks |
Retrieves winning/scoring streaks information for the match. |
| GET |
getMatchHighlights /api/handball/match/{id}/highlights |
Retrieves video highlights and key moments from the match. |
| GET |
getMatchBestPlayers /api/handball/match/{id}/best-players |
Retrieves the best performing players from the match. |
| GET |
getMatchFormAnalysis /api/handball/match/{id}/form |
Retrieves recent form and performance trends for teams in the match. |
| GET |
getMatchLineups /api/handball/match/{id}/lineups |
Retrieves starting lineups and player positions for both teams. |
| GET |
getMatchBettingOdds /api/handball/match/{id}/odds |
Retrieves betting odds from various bookmakers for the handball match. |
| GET |
getLiveHandballMatches /api/handball/matches/live |
Retrieves all currently live handball matches. |
| GET |
getHandballMatchDetails /api/handball/match/{id} |
Retrieves detailed information about a specific handball match. |
| Tournaments | ||
| GET |
getTeamEventsAwayStatistics /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/team-events/away |
Retrieves aggregated team performance statistics for away games. |
| GET |
getTournamentMedia /api/handball/unique-tournament/{tournamentId}/media |
Retrieves media content for the tournament. |
| GET |
getTournamentGroups /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/groups |
Retrieves group stage information for the tournament. |
| GET |
getTournamentDarkLogo /api/handball/unique-tournament/{tournamentId}/image/dark |
Retrieves the tournament's dark theme logo image. |
| GET |
getTopPlayersPerGame /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/top-players-per-game/all/overall |
Retrieves the best performing players based on per-game averages. |
| GET |
getTournamentDetails /api/handball/unique-tournament/{tournamentId} |
Retrieves comprehensive information about a handball tournament. |
| GET |
getPlayerStatisticsTypes /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/player-statistics/types |
Retrieves available player statistics categories for the tournament. |
| GET |
getTournamentAwayStandings /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/standings/away |
Retrieves standings based on away games only. |
| GET |
getTournamentMatchesByDate /api/handball/tournament/{tournamentId}/schedules/{day}/{month}/{year} |
Retrieves all tournament matches scheduled for a specific date. |
| GET |
getTeamEventsTotalStatistics /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/team-events/total |
Retrieves aggregated team performance statistics for all games. |
| GET |
getTournamentRounds /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/rounds |
Retrieves all rounds/game weeks for the tournament season. |
| GET |
getTournamentLastMatches /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/matches/last/{page} |
Retrieves recently played matches in the tournament. |
| GET |
getTournamentHomeStandings /api/handball/unique-tournament/{tournamentId}/season/{seasonId}/standings/home |
Retrieves standings based on home games only. |
HandballAPI pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 4 / second |
|
| PRO | $9.99 / month | 6 / second |
|
| ULTRA | $14.99 / month | 8 / second |
|
| MEGA Recommended | $24.99 / month | 10 / second |
|