Football Streaming & Match Data API Documentation

Welcome to the Football Streaming & Match Data API. Access complete football data including live scores, lineups, statistics, and streaming embeds using a simple endpoint structure.

1. Match List

Retrieve a list of fixtures with league details, scores, status, and team information.

GET /v2/

Parameters

Parameter	Required	Description
`type`	Yes	Must be set to `matches`.
`date`	No	Format: `YYYY-MM-DD`.
`status`	No	Filter by: `inprogress`, `notstarted`, or `finished`.

Notes:

Default Behavior: If no filters are applied, it shows all upcoming matches starting from the current time (UTC).
History Limit: Historical data is available for up to 7 days in the past.

Example:

/v2/?type=matches&date=2026-01-25&status=inprogress

2. Match Details & Info

Get specific data layers for a match (Lineups, Stats, H2H, etc).

GET /v2/

Parameters

Parameter	Required	Description
`type`	Yes	The data layer to retrieve (see options below).
`id`	Yes	The Match ID retrieved from the Match List endpoint.

Available 'type' Values:

detail
Returns general info: time, league, venue, referee, manager, and embed_url.
Note: Embed URLs often become available shortly before kickoff and may contain ads from the provider.
lineups
Returns: Starting XI, formation, bench, missing players, and player ratings.
Availability: ~1 hour before kickoff.
incidents
Returns: Timeline of goals, substitutions, cards, etc.
Availability: Live during the match.
stats
Returns: Live match statistics (possession, shots, etc).
Availability: Live during the match.
h2h
Returns: Head-to-head history (Max last 10 matches).
graph
Returns: Match momentum graph data.
Availability: Live during the match.
standing
Returns: League table associated with the match event.
Update: Refreshed after match completion.

Important Note: Data coverage (stats, lineups, etc.) depends on the event's popularity and source availability. Not all matches will have full detailed data.

Example:

/v2/?type=detail&id=123456