livescore.com APIlivescore.com ↗
Access live scores, fixtures, standings, and player stats for football, hockey, basketball, tennis, and cricket via the Livescore.com API.
curl -X GET 'https://api.parse.bot/scraper/18b659b8-239b-4706-8da0-75d743a2b334/get_scores_by_date_and_sport?date=2026-05-06&sport=basketball' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all matches for a given sport on a specific date, grouped by competition/league. Uses the LiveScore CDN API for real-time score data.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD or YYYYMMDD format. Defaults to today (UTC). |
| sport | string | Sport name. Accepted values: football, hockey, basketball, tennis, cricket. |
{
"type": "object",
"fields": {
"Ts": "integer, Unix timestamp of the response",
"Stages": "array of competition/league objects, each containing Events array with match details"
},
"sample": {
"data": {
"Ts": 1778148637,
"Stages": [
{
"Cnm": "Champions League",
"Sid": "24464",
"Snm": "Knockout Stage",
"CompN": "Champions League",
"Events": [
{
"T1": [
{
"Nm": "Arsenal"
}
],
"T2": [
{
"Nm": "Atletico Madrid"
}
],
"Eid": "1746709",
"Eps": "FT",
"Tr1": "1",
"Tr2": "0"
}
]
}
]
},
"status": "success"
}
}About the livescore.com API
This API exposes 12 endpoints covering live and historical sports data from Livescore.com across football, hockey, basketball, tennis, and cricket. The get_scores_by_date_and_sport endpoint returns all matches for a given date grouped by competition, while get_match_summary delivers per-match event timelines, lineups, and incidents. Response objects include Stages arrays with nested Events, making it straightforward to traverse multi-league result sets in a single call.
Score and Fixture Endpoints
The get_scores_by_date_and_sport endpoint accepts a date parameter in YYYY-MM-DD or YYYYMMDD format and a sport value (football, hockey, basketball, tennis, or cricket). It returns a top-level Ts Unix timestamp and a Stages array — each stage object represents a competition or league and contains an Events array with match details. Convenience wrappers exist for common cases: get_todays_football_scores, get_tomorrows_football_fixtures, and get_football_scores_by_date all follow the same response shape.
League-Level Endpoints
Four endpoints target a specific football league using a league slug (e.g. premier-league, serie-a) paired with a country slug (e.g. england, italy). get_league_fixtures returns upcoming scheduled matches in an initialData.stages structure. get_league_results returns the same shape for past matches. get_league_standings returns a Stages array containing LeagueTable objects with team standings. get_league_stats returns player leaderboards (top scorers and similar) via an initialData.stats array with availableGroups.
Match and Team Detail
get_match_summary takes a league, country, numeric match_id, and a match_slug in home-vs-away format. The response includes initialEventData with the match event details, goal and card incidents, scores, and status — match IDs can be obtained from the results or fixtures endpoints. get_team_overview takes a numeric team_id and team_slug, returning initialData with fields for nextOrCurrentMatch, recent results, stats, and squad header data.
Search
search_teams_and_competitions accepts a free-text query and returns two arrays: Teams (with team ID, name, and country info) and Stages (matching competitions). This is the primary way to resolve numeric team IDs before calling team-specific endpoints.
- Display a live football scores ticker grouped by league using the
StagesandEventsfields fromget_todays_football_scores. - Build a multi-sport scores dashboard by calling
get_scores_by_date_and_sportwith differentsportvalues for football, basketball, and hockey. - Generate weekly fixture lists for a specific league using
get_league_fixtureswith a league and country slug. - Populate a league table widget with team positions and points from the
LeagueTableobjects returned byget_league_standings. - Show match incident timelines — goals, cards, substitutions — in a match-detail view using
initialEventDatafromget_match_summary. - Resolve a team name to its numeric ID via
search_teams_and_competitionsbefore fetching form and upcoming fixtures fromget_team_overview. - Render a top-scorers leaderboard for a league by reading the
initialData.statsarray fromget_league_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 Livescore.com have an official developer API?+
What does `get_match_summary` return beyond the final score?+
initialEventData containing the full incident list (goals, yellow and red cards, and similar events), current match status, lineups, and streaming media information. The match_id required as input can be found in the Events arrays returned by get_league_results or get_league_fixtures.Does the API cover sports other than football at the league or team level?+
get_league_standings, get_league_stats, get_league_fixtures, get_league_results) and the team and match detail endpoints are football-only. Hockey, basketball, tennis, and cricket are accessible only through get_scores_by_date_and_sport and the football-agnostic convenience wrappers. You can fork this API on Parse and revise it to add league or team endpoints for other sports.Is historical match data available, and how far back does it go?+
get_football_scores_by_date endpoint accepts any past date via the date parameter, so historical scores are accessible. However, the API does not document a hard cutoff for how far back data remains available, and coverage for older seasons is subject to what Livescore.com retains. Detailed season-level archives are not a guaranteed scope of this API.