UK Football Results & Tables

What does UK Football Results & Tables do?

UK Football Results & Tables returns structured UK football match results and league tables for selected English and Scottish competitions. It focuses on supported domestic leagues only: English Premier League, English Championship, English League One, English League Two, and Scottish Premiership.

The actor is useful as a lightweight UK football API alternative when you need clean rows for dashboards, spreadsheets, scheduled updates, reporting workflows, or downstream data pipelines.

Why use UK Football Results & Tables?

Use this actor when you need UK football data in a consistent dataset instead of manually checking separate competition pages. You can select several competitions in one run, limit match output to a specific round or matchday, and return matches and calculated standings as two separate output tables.

Main capabilities:

• Retrieve fixtures, dates, teams, scores, status, and winners.
• Calculate standings from completed full-time results.
• Compare supported English and Scottish competitions in one normalized format.
• Schedule matchday runs on Apify and export data through the API.
• Append results into an existing Apify dataset with datasetId.
• Add your own workflow identifier with runId.

What data can it extract?

Field	Type	Description
leagueName	string	UK competition name
competitionType	string	league
competitionGender	string	men
country	string	England or Scotland
season	number	Season start year
round	number	Matchday when available
matchDate	string	Match date in ISO 8601 format
homeTeam, awayTeam	string	Teams for match rows
homeScore, awayScore	number	Full-time score when available
winner	string	home, away, draw, or empty
position, teamName, points	number/string	Standing row fields
played, won, drawn, lost	number	League record
goalsFor, goalsAgainst, goalDifference	number	League-table goal fields

Supported UK competitions

The dropdown currently supports:

• English Premier League
• English Championship
• English League One
• English League Two
• Scottish Premiership

This actor does not currently include Welsh or Northern Irish leagues because the free no-key dataset coverage is not stable enough for this launch scope.

Use cases

• Build UK football dashboards and matchday trackers.
• Keep spreadsheets of English and Scottish league results.
• Feed editorial tools with structured score and table data.
• Compare selected UK competitions in one normalized output.
• Schedule daily or matchday updates through Apify.
• Combine this dataset with club, attendance, media, or market workflows where legally permitted.

How to use it

1. Open the actor input tab.
2. Choose one or more UK competitions from the Competitions dropdown.
3. Set the season start year, for example 2025 for 2025/2026.
4. Optionally set Round to retrieve only one matchday.
5. Keep Include Matches enabled for fixtures and scores.
6. Keep Include Standings enabled when you want calculated league tables.
7. Run the actor and download the Matches and Standings tables as JSON, CSV, Excel, XML, or HTML.

Input

See the input tab for full configuration options.

Example input:

{
  "leagues": ["premier-league", "championship"],
  "season": 2025,
  "round": 1,
  "includeMatches": true,
  "includeStandings": true,
  "maxMatches": 20
}

For scheduled matchday updates, set round and keep maxMatches low. For full-season match exports, leave round blank and raise maxMatches. Standings rows are calculated from all completed full-time matches available for the selected season, not from the selected round only.

Output

The actor creates two output tables: Matches and Standings. You can download each dataset in various formats such as JSON, HTML, CSV, or Excel.

Example output:

[
  {
    "leagueName": "English Premier League",
    "competitionType": "league",
    "competitionGender": "men",
    "country": "England",
    "season": 2025,
    "round": 1,
    "matchDate": "2025-08-15T00:00:00.000Z",
    "status": "finished",
    "homeTeam": "Liverpool FC",
    "awayTeam": "AFC Bournemouth",
    "homeScore": 4,
    "awayScore": 2,
    "winner": "home"
  },
  {
    "leagueName": "English Premier League",
    "competitionType": "league",
    "competitionGender": "men",
    "country": "England",
    "season": 2025,
    "position": 1,
    "teamName": "Arsenal FC",
    "played": 35,
    "won": 25,
    "drawn": 7,
    "lost": 3,
    "goalsFor": 82,
    "goalsAgainst": 31,
    "goalDifference": 51,
    "points": 82
  }
]

API usage example

curl "https://api.apify.com/v2/acts/trovevault~uk-football-results-tables/runs?waitForFinish=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "leagues": ["premier-league", "championship"],
    "season": 2025,
    "round": 1,
    "includeMatches": true,
    "includeStandings": true,
    "maxMatches": 20
  }'

Limitations

This actor covers supported UK domestic league competitions only. It does not include Champions League, Europa League, national-team fixtures, cups, non-UK leagues, player-level scorer feeds, Welsh leagues, or Northern Irish leagues in this version.

Standings are calculated from completed full-time match results available in the public dataset. If some recent matches have not been updated yet, the calculated table can lag until the source dataset is updated.

FAQ

Does this actor include Champions League?

No. The scope is supported UK domestic leagues only.

Can I select multiple leagues?

Yes. The Competitions field is a multi-select dropdown.

Does the actor include cups?

No. This first version is league-only so that standings remain meaningful.

Which season format should I use?

Use the season start year. For example, 2025 means the 2025/2026 season.

Can I get only one round?

Yes. Set Round to a matchday number. Standings still use all completed season matches.

Does the actor include scorers?

No. This actor is standardized around match results and standings only.

Is the output suitable for spreadsheets?

Yes. Matches and standings are separate flat tables that export cleanly to CSV or Excel.

Can I append results to an existing dataset?

Yes. Fill datasetId to append rows to another Apify dataset in addition to the default run datasets. When both matches and standings are appended to this external dataset, the actor adds entityType so downstream workflows can distinguish match and standing rows.

Troubleshooting

If a run returns fewer rows than expected, check the selected season and round first. The free JSON dataset coverage for this actor starts at 2010/2011 for English leagues; Scottish Premiership coverage is newer. Older inputs such as 2000 are outside the supported source coverage, and the current season can be incomplete until public data updates land.

If standings do not match the selected round, that is expected: tables are calculated from the full available season, not one historical matchday.

For bugs, missing competitions, or output issues, use the Issues tab on the actor page.

Related actors

For a similar country-specific actor, see German Football Results & Tables.

Changelog

0.1

Initial version with supported UK football matches and calculated league tables.