Added limit filter to matches subresource
just a quick note: I added the limit filter to the team matches subresource, so if your programming language is lacking a head() or first() function on lists/collections, you can now easily get the latest match of your favourite team by firing:
Or the next upcoming match respectively:
Codes for Competitions back
I'm very happy to announce that I added values to the code-attribute of the competition resource back again (formerly known as leagueCodes).
They are back now and even more powerful as you can even use them now as identifier, e.g. by firing
you will always receive the matches for the active season of the English Premier League, without even touching your code. So your clients will run and run and run, season for season for season...
responds with all finished games from 1st to 8th of october for English Premier League and German Bundesliga.
Additionally I added back the crestUrl attribute to the team (sub)resources and the standings. I also cumulated it to be named "crestUrl"; v1 was mixing this up over the different resources.
I finally updated the small PHP code that shows basic functions of the API. You can have a look at it here:
On matches and status
with v2 matches have more fine grained status. See the status diagram below.
A match always starts with status "SCHEDULED". There is no TIMED status any more, so the regular workflow is a status change to IN_PLAY, to PAUSED, to IN_PLAY (again) and to FINISHED.
Take notice that there is a 'superior' status LIVE, that does not exist as a status per se, but you can use it in the matches resource as a filter. So you get all matches back that are currently IN_PLAY or PAUSED, thus LIVE :-)
AWARDED is also a new status as at times games find it's final result legally afterwards and mostly end 3 to 0 for one team then. Hope this is all clear and makes sense.
Finally - Football-Data API v2
Though Germany just got kicked out of the World Cup I'm very proud to announce, that v2 is finally online! It’s the biggest update of the API since I’ve started the project in 2014.
The top competitions will remain free in the new API. What was free in v1, remains free in v2 and will remain free forever!
The extra data/competitions are available under 3 new paid plans: Standard (25 competitions/€49 per month), Advanced (50 competitions/€99 per month) and Pro (144 competitions/€249 per month). These paid plans will help to support this project and fuel the development and growth of the football-data.org API.What’s new in v2?
- 144 competitions (leagues & cups) are now available through the API
- Live scores available for all matches
- Match fixtures are now updated every hour (instead of every day)
- League tables; Home/Away tables
- Match lineups and substitutes
- Goal scorers and assists
- Bookings (Yellow Cards, Red Cards)
- Team squads
There will be further updates in the upcoming days and weeks, so keep an eye on this blog to follow the latest changes.
If you have any questions, please contact me at daniel at football-data.org.best,
World Cup ahead
Besides maintaining the current data and API I'm working on a new release, v2 - hopefully including all proposals / feature requests of the last years. The release will be accompanied by a facelift of the frontend and find it's way to the public in March 2018. With new stuff to come other things will fade. That is alpha version which served faithfully millions of requests. Additionally support for the Event API is still stalled at the moment.
Major platform upgrade
things going on...
European Championships online.
official release of v1 the 2015/12/03.
small update: API outage on 15th of august.
Almost the end of the season: further roadmap
Small udpate: direct date usage
New feature: realtime scores
new attribute: status on fixture resource.
why one should use football-data.org
alpha on track.
introducing the timeframe argument
small pragmatism change: pluralization
new resource: fixture
let the games begin.
content update for new seasons data.
Actually I'm doing an initial import of all the new seasons' data at the moment. You can expect all data to be complete to the end of july. As you can see, moreover I decided to add a small blog section to keep you posted about important changes, explain features, best practices, hints and so on. cheers