Soccerway APIuk.soccerway.com ↗
Access football fixtures, scores, and team lineups from Soccerway. Get match status, kickoff times, formations, and player data across worldwide leagues.
What is the Soccerway API?
This API exposes 2 endpoints covering football fixtures and match lineups sourced from uk.soccerway.com. The get_fixtures endpoint returns match objects with competition name, team names, kickoff time, and score across all available leagues worldwide for any current or future date. The get_lineup endpoint delivers predicted and confirmed lineups with player names, shirt numbers, and formation-derived positions for a specific match.
curl -X GET 'https://api.parse.bot/scraper/03fedeb9-3b82-4620-9248-025a15e70e4e/get_fixtures?day_offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve football fixtures from Soccerway for a given day offset. Returns match details including competition name, teams, kickoff time or score, and match status for all available leagues worldwide. Only current and future dates are supported (day_offset >= 0).
| Param | Type | Description |
|---|---|---|
| day_offset | integer | Number of days from today into the future. 0 for today, 1 for tomorrow, 2 for the day after, etc. Must be 0 or greater; negative values are rejected. |
{
"type": "object",
"fields": {
"fixtures": "array of match objects, each containing competition, match_id, home_team, away_team, display (kickoff time as HH:MM UTC or score as H:A), status_code, kickoff_timestamp, home_score, and away_score",
"total_count": "integer total number of fixtures returned"
},
"sample": {
"data": {
"fixtures": [
{
"display": "00:30",
"match_id": "MiHypBQh",
"away_team": "Dakota",
"home_team": "La Fama",
"away_score": null,
"home_score": null,
"competition": "ARUBA: Division di Honor - Final Group",
"status_code": "1",
"kickoff_timestamp": "1781137800"
},
{
"display": "09:00",
"match_id": "6Lh4Dnoo",
"away_team": "Cambodia U19",
"home_team": "Thailand U19",
"away_score": null,
"home_score": null,
"competition": "ASIA: ASEAN Championship U19 - Play Offs",
"status_code": "1",
"kickoff_timestamp": "1781168400"
}
],
"total_count": 144
},
"status": "success"
}
}About the Soccerway API
Fixtures by Date
The get_fixtures endpoint accepts a day_offset integer parameter (0 or greater) representing how many days from today to query. A value of 0 returns today's fixtures, 1 returns tomorrow's, and so on. Only current and future dates are supported — past dates are not queryable. Each fixture object in the response includes competition, match_id, home_team, away_team, display (either a HH:MM UTC kickoff time for upcoming matches or a score for completed ones), and status. The total_count field gives the total number of fixtures returned across all leagues.
Match Lineups
The get_lineup endpoint takes a match_id string sourced from a get_fixtures response and returns lineup data for that specific match. The lineup_type field indicates whether the lineup is predicted, confirmed, or unavailable. Both home_team and away_team objects include a formation string, a players array with shirt numbers and player names, and position data derived from the formation. For completed matches, confirmed lineups may also include substitute information. Either team object can be null if lineup data is not available for that side.
Coverage and Identifiers
Fixture coverage spans leagues worldwide as indexed on Soccerway. The match_id returned by get_fixtures (e.g. C0b6Sk9l) is the stable identifier used to query get_lineup, making it straightforward to chain the two endpoints — retrieve a day's fixtures, then pull lineups for individual matches of interest.
The Soccerway API is a managed, monitored endpoint for uk.soccerway.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when uk.soccerway.com 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 uk.soccerway.com 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 football fixture digest app showing kickoff times and competition names across global leagues
- Display live or final scores for today's matches using the
displayfield fromget_fixtures - Generate predicted starting XI previews before a match using formation and player data from
get_lineup - Track confirmed lineups and substitutes for post-match analysis after matches complete
- Power a fixture calendar showing upcoming matches by querying incremental
day_offsetvalues - Cross-reference team names and competition names from fixtures to enrich a football database
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Soccerway provide an official developer API?+
What does `lineup_type` tell me, and when is it set to 'unavailable'?+
lineup_type field from get_lineup is predicted when the match has not yet kicked off and projected lineups are available, confirmed when the match has completed and official lineups are recorded, and unavailable when no lineup data exists for that match. In the unavailable case, both home_team and away_team objects will be null.Can I query fixtures for past dates?+
get_fixtures endpoint only supports day_offset values of 0 or greater, meaning today and future dates only. Historical fixture results and past scores are not covered by the current endpoints. You can fork this API on Parse and revise it to add a historical fixtures endpoint if past match data is needed.Does the API include player statistics such as goals, assists, or cards within a match?+
Are fixtures filtered by league or competition, or does the response include everything?+
get_fixtures endpoint returns all available fixtures worldwide for the given day in a single response — there is no league or competition filter parameter. You can filter client-side using the competition field on each fixture object. Filtering by league at the request level is not currently supported; you can fork this API on Parse and revise it to add a competition filter parameter.