flashscore.com.tr APIflashscore.com.tr ↗
Access live football scores, daily fixtures, match statistics, lineups with player ratings, and bet365 odds via the Flashscore.com.tr API.
curl -X GET 'https://api.parse.bot/scraper/4ff158f6-8960-40ee-aa69-044007d0f5a4/get_football_matches?date_offset=-1' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract all available football matches for a given date offset relative to today. Returns match fixtures with scores, status, league info, and start times. Supports today, future, and past dates.
| Param | Type | Description |
|---|---|---|
| date_offset | integer | Date offset from today: 0 for today, 1 for tomorrow, -1 for yesterday, etc. |
{
"type": "object",
"fields": {
"total": "integer total number of matches",
"matches": "array of match objects with id, league, home_team, away_team, home_score, away_score, status, start_time, and match_url"
},
"sample": {
"data": {
"total": 1467,
"matches": [
{
"id": "258TuxPH",
"league": "ABD: MLS",
"status": "Finished",
"away_team": "Orlando City",
"home_team": "Inter Miami",
"match_url": "https://www.flashscore.com.tr/mac/258TuxPH/",
"status_id": "3",
"away_score": "4",
"home_score": "3",
"start_time": "2026-05-02T23:15:00",
"status_text": null
}
]
},
"status": "success"
}
}About the flashscore.com.tr API
The Flashscore.com.tr API covers football match data across 5 endpoints, returning fixtures, live scores, match events, team statistics, lineups with player ratings, and bet365 1X2 odds. The get_football_matches endpoint accepts a date_offset integer so you can retrieve any day's schedule — past or future — while companion endpoints expose per-match detail using the match ID returned in those results.
Match Fixtures and Scores
The get_football_matches endpoint is the entry point for the API. Pass a date_offset integer (0 for today, 1 for tomorrow, -1 for yesterday, and so on) to retrieve all football matches for that date. Each match object in the response includes a unique id, league, home_team, away_team, home_score, away_score, status, start_time, and match_url. The total field reports how many matches were found. The match id is the key required by all four detail endpoints.
Match Events and Statistics
get_match_summary returns an events array for a given event_id, where each event carries a type, minute, side, player, and action (goal, card, substitution, or other). Scheduled matches return an empty array. get_match_statistics returns stats grouped by period, with each row carrying name, home_value, and away_value — covering metrics such as possession, shots on target, corners, and expected goals (xG). Scheduled matches may return zero values across all fields.
Lineups and Odds
get_match_lineups returns separate home and away objects, each containing formation, team_rating, a starting_xi array, a substitutes array, and a coaches array. Player ratings are included where available; lineups are only populated for completed or in-progress matches. get_match_odds returns full-time home/draw/away odds sourced from bet365, with value, opening, active, and change fields for each outcome. The bet_type is always HOME_DRAW_AWAY and bet_scope is always FULL_TIME.
- Build a daily fixture tracker showing match status and scores for any date using
date_offset - Display live match timelines with goals, cards, and substitutions from
get_match_summary - Compare team performance with possession, xG, and shot data from
get_match_statistics - Show starting formations and per-player ratings for pre- or post-match analysis via
get_match_lineups - Monitor bet365 opening vs. current 1X2 odds movement for a specific match using
get_match_odds - Aggregate league-wide results for a past date by iterating over matches from
get_football_matches
| 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 Flashscore have an official developer API?+
What does `get_match_odds` actually return, and does it cover multiple bookmakers?+
home, draw, away) includes the current value, the opening odds, an active flag, and a change direction indicator. Odds from other bookmakers are not currently exposed. You can fork this API on Parse and revise it to add additional bookmaker odds if the source makes them available.Will detail endpoints return data for a match that hasn't started yet?+
get_match_summary and get_match_lineups return empty arrays for scheduled matches. get_match_statistics may return zeroed-out values. Only get_football_matches consistently returns meaningful data for future dates — it provides fixture metadata like start_time, league, and team names regardless of match status.Does the API cover competitions other than football, such as basketball or tennis?+
Is there pagination for `get_football_matches` when a date has many matches?+
total count field. There is no pagination parameter — the full set for that day is returned at once. Very high-volume dates may produce large response payloads.