Com APIflashscore.com.ua ↗
Access football match results, fixtures, team histories, events, and in-match statistics from Flashscore.com.ua via a structured JSON API.
What is the Com 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.
curl -X GET 'https://api.parse.bot/scraper/ee993dc6-7c07-47c8-a6e6-6075e825e247/get_football_results_by_date?date_offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace flashscore-com-ua-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.flashscore_football_api import Flashscore, Match, Team, MatchDetail, MatchStatistics, ConsecutiveDrawsReport, TeamAnalysis, MatchNotFound
client = Flashscore()
# Get today's matches across all competitions
for match in client.matches.by_date(date_offset=0):
print(match.home_team, match.home_score, match.away_score, match.away_team, match.competition)
# Construct a team by ID and fetch their recent results
team = client.team(team_id="M9UocgKt")
for match in team.results(country_id="24"):
print(match.match_id, match.home_team, match.home_score, match.away_score, match.away_team)
# Drill into a specific match for events and statistics
first_match = client.match(match_id="OvKeupeC")
detail = first_match.details()
for event in detail.events:
print(event.minute, event.event_type, event.player, event.team)
stats = first_match.statistics()
for stat in stats.statistics:
print(stat.stat_name, stat.home_value, stat.away_value, stat.period)
# Analyze a team for consecutive 0:0 draws
report = team.analyze_draws()
print(report.total_teams_checked, report.total_with_consecutive_0_0)
for analysis in report.team_analyses:
print(analysis.team_id, analysis.team_name, analysis.has_consecutive_0_0, analysis.matches_found)
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. A single request returns all matches for that day grouped by competition.
| 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": "Австралия",
"match_id": "OvKeupeC",
"away_team": "Canberra White Eagles",
"home_team": "Belconnen Utd.",
"timestamp": 1781083800,
"away_score": "2",
"country_id": "24",
"home_score": "1",
"league_url": "/football/australia/npl-act/",
"competition": "АВСТРАЛИЯ: НПЛ АСТ",
"status_code": "3",
"away_team_id": "jcQwCm5i",
"home_team_id": "M9UocgKt"
}
]
},
"status": "success"
}
}About the Com API
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.
The Com API is a managed, monitored endpoint for flashscore.com.ua — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when flashscore.com.ua changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official flashscore.com.ua API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.