flashscore.com.ua APIflashscore.com.ua ↗
Access football match results, fixtures, team histories, events, and in-match statistics from Flashscore.com.ua via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/ee993dc6-7c07-47c8-a6e6-6075e825e247/get_football_results_by_date?date_offset=-1' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve football match results and fixtures for a specific date across all competitions. Returns both completed matches with scores and upcoming scheduled matches. The date is calculated relative to today using an offset.
| Param | Type | Description |
|---|---|---|
| date_offset | integer | Date offset from today (0=today, -1=yesterday, -2=two days ago, 1=tomorrow, etc.). |
{
"type": "object",
"fields": {
"matches": "array of match objects containing match_id, timestamp, home_team, away_team, home_score, away_score, home_team_id, away_team_id, status_code, competition, country, country_id, league_url"
},
"sample": {
"data": {
"matches": [
{
"country": "Australia",
"match_id": "Aqx3KMCO",
"away_team": "Cockburn City",
"home_team": "Gwelup Croatia",
"timestamp": 1778065200,
"away_score": "4",
"country_id": "24",
"home_score": "4",
"league_url": "/football/australia/wa-state-league/",
"competition": "AUSTRALIA: WA State League",
"status_code": "3",
"away_team_id": "A35Nsla5",
"home_team_id": "virVnCv5"
}
]
},
"status": "success"
}
}About the flashscore.com.ua API
This API exposes 5 endpoints covering football match data from Flashscore.com.ua, including results by date, team fixtures, match events, and in-match statistics. The get_football_results_by_date endpoint returns match objects with scores, team identifiers, competition context, and timestamps for any date offset from today — past or future. Match IDs returned throughout the API chain into get_match_details and get_match_statistics for event-level and performance data.
Match Results and Fixtures
get_football_results_by_date accepts a date_offset integer relative to today (e.g. 0 for today, -1 for yesterday, 1 for tomorrow) and returns an array of match objects. Each match includes match_id, timestamp, home_team, away_team, home_score, away_score, home_team_id, away_team_id, and status. Both completed matches with final scores and upcoming scheduled fixtures appear in the same response. The team_id and country_id values from these results are the inputs for team-level queries.
Team History and Consecutive Draw Analysis
get_team_results takes a team_id (e.g. 'bL3ChiWQ') and an optional country_id that must match the team's actual country — mismatched country_id values return empty results. The response mirrors the match object structure and covers both recent completed games and upcoming fixtures for that team. For pattern detection, get_teams_with_consecutive_0_0_draws accepts a JSON array of team IDs and returns per-team analysis: has_consecutive_0_0, the consecutive_0_0_match_ids when present, and aggregate counts (total_teams_checked, total_with_consecutive_0_0).
Match Events and In-Match Statistics
get_match_details returns an events array for a given match_id. Each event object carries event_id, period, team, minute, event_type (goal, card, substitution), player, player_id, and the running score at that moment via score_home and score_away. Events are available for finished matches; live or scheduled matches return an empty array. get_match_statistics returns a statistics array where each entry has period, category, stat_name, home_value, and away_value — covering metrics like possession, shots, and corners. Not all matches have statistics; those without return an empty array.
- Build a daily match digest by pulling all results for a given date offset and filtering by competition.
- Track a specific club's form by retrieving its recent matches via get_team_results and computing win/draw/loss sequences.
- Identify 0-0 draw patterns across a watchlist of teams using get_teams_with_consecutive_0_0_draws.
- Reconstruct a full match timeline by chaining get_match_details events sorted by minute.
- Compare possession and shot accuracy between two teams from get_match_statistics stat objects.
- Aggregate goal scorers and assist data across a matchday by iterating match IDs from get_football_results_by_date.
- Alert systems for upcoming fixtures by querying positive date offsets and filtering by team_id.
| 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.