Football Web Pages.co.uk

Feeds

All of the data that makes up our various pages (fixtures/results, league tables, match details, news, etc.) is available via the feeds that we make available. You can choose to access these in any of the following formats: CSV, JSON or XML.

At this time, all of our feeds are freely available for anybody to use. However, any single IP address may only make 360 requests in any hour; this equates to one request every ten seconds. Should you reach the limit you will receive a 429 "too many requests" response and we will set the "Retry-After" header, which will tell you after how many seconds you may try again.

Please see the details of the various feeds below, or find a page on our site which contains the data that you want and then use the "Download the data via our feeds" link at the bottom of the screen.

Appearances
Base addresshttps://www.footballwebpages.co.uk/appearances.csv
https://www.footballwebpages.co.uk/appearances.json
https://www.footballwebpages.co.uk/appearances.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
PlayerPlayer ID - see here
Integer; optional
Example: player=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
MaxMaximum number of results
Integer; optional; default: 20
Example: max=48
Examplehttps://www.footballwebpages.co.uk/appearances.json?comp=1&max=48
Attendances
Base addresshttps://www.footballwebpages.co.uk/attendances.csv
https://www.footballwebpages.co.uk/attendances.json
https://www.footballwebpages.co.uk/attendances.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
SortHow to sort the attendance
String [ average | maximum | minimum ]; optional; default: average; ignored if team is specified
Example: sort=maximum
TypeThe type of matches to include
String [ home | away | all ]; optional; default: home
Example: type=away
Examplehttps://www.footballwebpages.co.uk/attendances.json?comp=1&sort=maximum&type=away
Competitions
Base addresshttps://www.footballwebpages.co.uk/competitions.csv
https://www.footballwebpages.co.uk/competitions.json
https://www.footballwebpages.co.uk/competitions.xml
 No parameters may be set for this feed
Examplehttps://www.footballwebpages.co.uk/competitions.json
Fixtures and Results
Base addresshttps://www.footballwebpages.co.uk/fixtures-results.csv
https://www.footballwebpages.co.uk/fixtures-results.json
https://www.footballwebpages.co.uk/fixtures-results.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
RoundRound ID - see here
Integer; optional; ignored if team is specified
Example: round=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
FixturesNumber of un-finished matches to include
Integer; optional; default: all; ignored if month is specified; if specified the system will complete a day of matches and so may return slightly more than this number
Example: fixtures=5
ResultsNumber of completed matches to include
Integer; optional; default: all; ignored if month is specified; if specified the system will complete a day of matches and so may return slightly more than this number
Example: results=0
MonthMonth
Integer [ 1 - 12 ]; optional
Example: month=8
Examplehttps://www.footballwebpages.co.uk/fixtures-results.json?comp=1&fixtures=5&results=0
Form Guide
Base addresshttps://www.footballwebpages.co.uk/form-guide.csv
https://www.footballwebpages.co.uk/form-guide.json
https://www.footballwebpages.co.uk/form-guide.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
CountThe number of matches to include
String [ four | six | eight ]; optional; default: six
Example: count=four
TypeThe type of matches to include
String [ all | home | away ]; optional; default: all
Example: type=home
DetailsWhether to include details of the match
String [ yes | no ]; optional; default: yes
Example: details=no
Examplehttps://www.footballwebpages.co.uk/form-guide.json?comp=1&count=four&type=home&details=no
Goalscorers
Base addresshttps://www.footballwebpages.co.uk/goalscorers.csv
https://www.footballwebpages.co.uk/goalscorers.json
https://www.footballwebpages.co.uk/goalscorers.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
PlayerPlayer ID - see here
Integer; optional
Example: player=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
MaxMaximum number of results
Integer; optional; default: 20
Example: max=48
Examplehttps://www.footballwebpages.co.uk/goalscorers.json?comp=1&max=48
League Progress
Base addresshttps://www.footballwebpages.co.uk/league-progress.csv
https://www.footballwebpages.co.uk/league-progress.json
https://www.footballwebpages.co.uk/league-progress.xml
TeamTeam ID - see here
Integer; required
Example: team=1
ShowThe type(s) of progress to show
String [ points | progress | both ]; optional; default: both
Example: show=position
Examplehttps://www.footballwebpages.co.uk/league-progress.json?team=1&show=position
League Table
Base addresshttps://www.footballwebpages.co.uk/league-table.csv
https://www.footballwebpages.co.uk/league-table.json
https://www.footballwebpages.co.uk/league-table.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
ColumnsWhich columns to include
String of comma-separated values from "pos,p,w,d,l,f,a,gd,pts"; optional; default: all columns
Example: show=pos,w,d,l,pts
Home/awayWhether to include the separate home and away totals
String [ yes | no ]; optional; default: no
Example: showHa=yes
RangeHow many rows to return
Integer; optional; default: all
Example: range=5
SortHow to sort the league table
String [ normal | home | away | scored | conceded | ppm | predicted ]; optional; default: normal
Example: sort=home
StartWhich position to start with
Integer; optional; default: 1
Example: start=6
Examplehttps://www.footballwebpages.co.uk/league-table.json?comp=1&range=5&show=pos,w,d,l,pts&showHa=yes&sort=home&start=6
Match
Base addresshttps://www.footballwebpages.co.uk/match.json
https://www.footballwebpages.co.uk/match.xml
 Please be aware that this feed is not available as a CSV
MatchMatch ID
Integer; required
Example: match=111981
Examplehttps://www.footballwebpages.co.uk/match.json?match=111981
Match Grid
Base addresshttps://www.footballwebpages.co.uk/match-grid.csv
https://www.footballwebpages.co.uk/match-grid.json
https://www.footballwebpages.co.uk/match-grid.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
Examplehttps://www.footballwebpages.co.uk/match-grid.json?comp=1
News
Base addresshttps://www.footballwebpages.co.uk/news.csv
https://www.footballwebpages.co.uk/news.json
https://www.footballwebpages.co.uk/news.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
MaxMaximum number of results
Integer; optional; default: 20
Example: max=48
Examplehttps://www.footballwebpages.co.uk/news.json?comp=1&max=48
Players
Base addresshttps://www.footballwebpages.co.uk/players.csv
https://www.footballwebpages.co.uk/players.json
https://www.footballwebpages.co.uk/players.xml
TeamTeam ID - see here
Integer; required
Example: team=1
Examplehttps://www.footballwebpages.co.uk/players.json?team=1
Records
Base addresshttps://www.footballwebpages.co.uk/records.csv
https://www.footballwebpages.co.uk/records.json
https://www.footballwebpages.co.uk/records.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
Examplehttps://www.footballwebpages.co.uk/records.json?team=1
Rounds
Base addresshttps://www.footballwebpages.co.uk/rounds.csv
https://www.footballwebpages.co.uk/rounds.json
https://www.footballwebpages.co.uk/rounds.xml
CompetitionCompetition ID - see here
Integer; optional
Example: comp=21
Examplehttps://www.footballwebpages.co.uk/rounds.json?comp=21
Sequences
Base addresshttps://www.footballwebpages.co.uk/sequences.csv
https://www.footballwebpages.co.uk/sequences.json
https://www.footballwebpages.co.uk/sequences.xml
TeamTeam ID - see here
Integer; required
Example: team=1
Examplehttps://www.footballwebpages.co.uk/sequences.json?team=1
Teams
Base addresshttps://www.footballwebpages.co.uk/teams.csv
https://www.footballwebpages.co.uk/teams.json
https://www.footballwebpages.co.uk/teams.xml
CompetitionCompetition ID - see here
Integer; optional; default: all competitions
Example: comp=1
Examplehttps://www.footballwebpages.co.uk/teams.json?comp=1
Videos
Base addresshttps://www.footballwebpages.co.uk/videos.csv
https://www.footballwebpages.co.uk/videos.json
https://www.footballwebpages.co.uk/videos.xml
CompetitionCompetition ID - see here
Integer; optional
Example: comp=1
TeamTeam ID - see here
Integer; optional
Example: team=1
MaxMaximum number of results
Integer; optional; default: 20
Example: max=12
Examplehttps://www.footballwebpages.co.uk/videos.json?max=12
Vidiprinter
Base addresshttps://www.footballwebpages.co.uk/vidiprinter.csv
https://www.footballwebpages.co.uk/vidiprinter.json
https://www.footballwebpages.co.uk/vidiprinter.xml
CompetitionCompetition ID - see here
Integer; optional, although one of competition/team is required
Example: comp=1
TeamTeam ID - see here
Integer; optional, although one of competition/team is required
Example: team=1
DateDate
Integer: YYYYMMDD; optional; default: most recent set of matches
Example: date=20181021
Examplehttps://www.footballwebpages.co.uk/vidiprinter.json?comp=1&date=20181021