h2hggl.com APIh2hggl.com ↗
Access H2H GG League eBasketball schedules, live scores, match stats, play-by-play timelines, player stats, and head-to-head comparisons via 9 endpoints.
curl -X GET 'https://api.parse.bot/scraper/dd72b5c0-aef0-43c1-9cc0-4246bb6dbe2b/get_schedule?date=%3CYYYY-MM-DD%3E&days=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all eBasketball games for a specific date or date range. Returns both upcoming and completed games with scores, teams, and participant info.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD format. Defaults to today (UTC). |
| days | integer | Number of days to fetch starting from date. |
{
"type": "object",
"fields": {
"games": "array of game objects with externalId, startDate, teamAName, teamBName, participantAName, participantBName, matchStatus, teamAScore, teamBScore",
"date_range": "object containing from, to (YYYY-MM-DD strings), and days (integer)",
"total_games": "integer total number of games in the range"
},
"sample": {
"data": {
"games": [
{
"_date": "2026-05-07",
"startDate": "2026-05-07T23:27:00Z",
"teamAName": "New York Knicks",
"teamBName": "Boston Celtics",
"externalId": "NB212070526",
"streamName": "Ebasketball 4",
"teamAScore": null,
"teamBScore": null,
"isCancelled": false,
"matchStatus": null,
"tournamentName": "Ebasketball H2H GG League",
"_status_category": "upcoming",
"participantAName": "SUPERIOR",
"participantBName": "BLADE"
}
],
"date_range": {
"to": "2026-05-07",
"days": 1,
"from": "2026-05-07"
},
"total_games": 187
},
"status": "success"
}
}About the h2hggl.com API
The H2H GG League API covers 9 endpoints for eBasketball data including schedules, live scores, per-match box scores, play-by-play timelines, and player career statistics. The get_schedule endpoint accepts a date and days range to return game objects with team names, participant names, and scores. The get_h2h endpoint delivers side-by-side career stat comparisons and historical head-to-head results between any two named players.
Schedule and Live Data
The get_schedule endpoint returns all H2H GG League eBasketball games for a given date or date range. Pass a date string in YYYY-MM-DD format and an optional days integer to widen the window. Each game object includes externalId, startDate, teamAName, teamBName, participantAName, participantBName, matchStatus, and both team scores. The get_live_games endpoint narrows this to currently active and immediately upcoming matches, adding a streamName field and a status field, making it useful for real-time display.
Match Details and Timeline
Once you have a match's externalId (formatted like NB251200426), you can call get_match_details to retrieve both the full box score and the play-by-play in a single response. Box score data is broken into period stat objects (quarter-1 through quarter-4 and end-match), each containing teamA and teamB sub-objects. The timeline field returns an incidents array covering events such as goals, fouls, free throws, and period changes, plus a matchSummary with teams, scores, and start date. If you only need one or the other, get_match_stats returns box score data alone and get_match_timeline returns the play-by-play alone. Note that get_match_stats returns an empty stats array for matches where matchStatus is not MATCH_ENDED.
Player Statistics and Head-to-Head
get_players returns all eBasketball players with fields including avgPoints, matchesPlayed, matchesWon, matchesLost, matchesWinPct, and matchForm. To drill into a single player, pass their name (case-insensitive) to get_player_stats, which adds a recent_games array of completed matches. get_player_past_games focuses exclusively on that game history, returning a flat array of completed game objects with scores and participant names. For matchup analysis, get_h2h accepts two player names and returns participantAStats, participantBStats, an h2H array of historical results between the two, and matchDetails.
- Build a live eBasketball scoreboard using
get_live_gamesto poll current match scores and statuses. - Populate a daily fixture calendar by calling
get_schedulewith adaysrange to fetch upcoming games across multiple dates. - Display quarter-by-quarter box scores for completed matches using the period stat objects from
get_match_stats. - Render play-by-play commentary feeds from the
incidentsarray returned byget_match_timeline. - Show player career leaderboards sorted by
avgPoints,matchesWinPct, ormatchFormfrom theget_playersendpoint. - Generate head-to-head preview cards for two players before a scheduled match using
get_h2hcareer and H2H result data. - Track a specific player's recent form by reading the
recent_gamesarray fromget_player_stats.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does H2H GG League have an official developer API?+
What does `get_match_stats` return for a live or upcoming match?+
stats array. Box score period data — quarter-1 through quarter-4 and end-match objects — is only populated once the match reaches matchStatus=MATCH_ENDED. Use get_live_games to track scores during play.Does the API cover tournament brackets, league standings, or season-level tables?+
How far back does `get_player_past_games` go, and is there pagination?+
total_games integer but no offset or page controls. If you need deeper historical data beyond what the endpoint returns, you can fork the API on Parse and revise it to add pagination support.Can I look up team-level stats independently of individual matches or players?+
teamAName, teamBName) within match and player objects rather than as a standalone team-stats endpoint. You can fork this API on Parse and revise it to add a dedicated team statistics endpoint.