https://v4.{sport}.sportsapipro.com and require the x-api-key header (except /health).
System
| Method | Path | Description | Cache |
|---|---|---|---|
| GET | /health | Health check — { status, browserReady, timestamp } (no auth) | — |
Catalog
| Method | Path | Description | Cache |
|---|---|---|---|
| GET | /api/v1/sports | All 17 sports with id/slug | 1h |
| GET | /api/v1/navigation | Site navigation: sports + categories + top leagues | 1h |
| GET | /api/v1/bookmakers | All bookmakers (filter: geoCode) | 1h |
| GET | /api/v1/bookmakers/top | Top bookmaker for a region | 1h |
| GET | /api/v1/bookmakers/payouts | Payout rankings (sport, market) | 1h |
| GET | /api/v1/categories | Categories / countries with match counts | 10m |
| GET | /api/v1/leagues | League list (sport, topOnly, geoCode) | 10m |
Matches
| Method | Path | Description | Cache |
|---|---|---|---|
| GET | /api/v1/matches | Paginated match list (sport, status, page, perPage, startDate, endDate) | 30s live / 2m other |
| GET | /api/v1/matches/smart-bets | Match list with smart-bet overlay | 2m |
| GET | /api/v1/{sport}/live | Live matches for a sport | 30s |
| GET | /api/v1/{sport}/today | Today’s matches | 2m |
| GET | /api/v1/{sport}/tomorrow | Tomorrow’s matches | 2m |
| GET | /api/v1/{sport}/yesterday | Yesterday’s matches | 2m |
| GET | /api/v1/{sport}/all | All matches for the day | 2m |
| GET | /api/v1/odds/max | Best odds per match across all bookmakers | 30s live / 2m other |
Match Lookup
| Method | Path | Description | Cache |
|---|---|---|---|
| GET | /api/v1/match/{id} | Full match info (teams, venue, standings context, form, H2H) | 1m |
| GET | /api/v1/match/{id}/info | Alias — same payload as /match/{id} | 1m |
| GET | /api/v1/match/{id}/odds | Full odds comparison (oddGroupId filter) | 1m |
| GET | /api/v1/match/{id}/odds-movements | Historical line movements (offerType, inplay) | 2m |
| GET | /api/v1/match/{id}/markets | Available markets for the match | 5m |
| GET | /api/v1/match/{id}/prediction | Community prediction percentages | 5m |
League Lookup
| Method | Path | Description | Cache |
|---|---|---|---|
| GET | /api/v1/league/{id}/standings | League table (season optional) | 10m |
| GET | /api/v1/league/{id}/top-scorers | Top scorers | 10m |
| GET | /api/v1/league/{id}/outrights | Outright / futures odds | 5m |
| GET | /api/v1/league/{id}/special-offers | Bookmaker promotions for the league | 1h |
Team Lookup
| Method | Path | Description | Cache |
|---|---|---|---|
| GET | /api/v1/team/{id} | Team info (venue, manager, leagues) | 10m |
| GET | /api/v1/team/{id}/matches | Upcoming + finished matches (leagueId, upcomingLimit, finishedLimit) | 5m |
| GET | /api/v1/team/{id}/offers | Bookmaker special offers + welcome bonuses for the team | 1h |
Community & Insights
| Method | Path | Description | Cache |
|---|---|---|---|
| GET | /api/v1/polls | Community votes (sport, league, category) | 5m |
| GET | /api/v1/tipsters | Top tipsters (sportId, leagueId, limit) | 10m |
| GET | /api/v1/news | Betting news / blog posts (sport, page, perPage) | 10m |