{"id":19179209,"url":"https://github.com/nearhuscarl/footballdataapi","last_synced_at":"2026-03-15T00:10:43.399Z","repository":{"id":40748839,"uuid":"179775308","full_name":"NearHuscarl/FootballDataAPI","owner":"NearHuscarl","description":"Football data API wrapper https://www.football-data.org","archived":false,"fork":false,"pushed_at":"2023-01-03T19:19:43.000Z","size":2659,"stargazers_count":7,"open_issues_count":19,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-07T21:46:05.134Z","etag":null,"topics":["api","football","football-data","nodejs"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NearHuscarl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-06T01:19:07.000Z","updated_at":"2025-04-06T06:42:51.000Z","dependencies_parsed_at":"2023-02-01T09:16:36.131Z","dependency_job_id":null,"html_url":"https://github.com/NearHuscarl/FootballDataAPI","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NearHuscarl%2FFootballDataAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NearHuscarl%2FFootballDataAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NearHuscarl%2FFootballDataAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NearHuscarl%2FFootballDataAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NearHuscarl","download_url":"https://codeload.github.com/NearHuscarl/FootballDataAPI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252961858,"owners_count":21832192,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","football","football-data","nodejs"],"created_at":"2024-11-09T10:42:27.697Z","updated_at":"2026-03-15T00:10:43.353Z","avatar_url":"https://github.com/NearHuscarl.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Football Data API\n\n![npm (scoped)](https://img.shields.io/npm/v/footballdata-api-v2.svg)\n[![Build Status](https://api.travis-ci.com/NearHuscarl/FootballDataAPI.svg?branch=master)](https://travis-ci.com/NearHuscarl/FootballDataAPI)\n[![Code Coverage](https://img.shields.io/codecov/c/github/NearHuscarl/FootballDataAPI.svg?maxAge=2592000)](https://codecov.io/github/NearHuscarl/FootballDataAPI?branch=master)\n![license](https://img.shields.io/npm/l/footballdata-api-v2.svg?color=blue)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n\n[![npm badge][npm-badge-png]][package-url]\n\n## Installation\n\n```bash\n$ npm install footballdata-api-v2\n```\n\nGet the API key (free) from [football data]\n\n## Import\n\n```js\nimport FootballData from 'footballdata-api-v2';\nconst footballData = new FootballData(YOUR_API_KEY);\n```\n\n## Usages\n\nSee [football data quickstart] for more information about filters and data types\n\n### Get header data\n\nYou can attach additional data from the API header response by adding `true` in the second argument in every methods below to get some meta info like remaining requests until blocked\n\nThe free plan allows 10 API calls/minute\n\n```js\nfootballData.getCompetitions({\n    areas: 2088, // Germany\n    plan: 'TIER_TWO',\n}, true).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    ...\n    \"api\": {\n        \"version\": \"v2\",\n        \"client\": \"NearHuscarl\",\n        \"secLeftUntilReset\": 60,\n        \"remainingRequests\": 9\n    }\n}\n```\n\u003c/details\u003e\n\n### Get all competitions\n```js\nfootballData.getCompetitions({\n    areas: 2088, // Germany\n    plan: 'TIER_TWO',\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 3,\n    \"filters\": {\n        \"areas\": [\n            2088\n        ],\n        \"plan\": \"TIER_TWO\"\n    },\n    \"competitions\": [\n        {\n            \"id\": 2002,\n            \"area\": {\n                \"id\": 2088,\n                \"name\": \"Germany\"\n            },\n            \"name\": \"Bundesliga\",\n            \"code\": \"BL1\",\n            \"emblemUrl\": null,\n            \"plan\": \"TIER_ONE\",\n            \"currentSeason\": {\n                \"id\": 155,\n                \"startDate\": \"2018-08-24\",\n                \"endDate\": \"2019-05-18\",\n                \"currentMatchday\": 28,\n                \"winner\": null\n            },\n            \"numberOfAvailableSeasons\": 23,\n            \"lastUpdated\": \"2019-04-06T00:00:38Z\"\n        },\n        {\n            \"id\": 2011,\n            \"area\": {\n                \"id\": 2088,\n                \"name\": \"Germany\"\n            },\n            \"name\": \"DFB-Pokal\",\n            \"code\": \"DFB\",\n            \"emblemUrl\": null,\n            \"plan\": \"TIER_TWO\",\n            \"currentSeason\": {\n                \"id\": 12,\n                \"startDate\": \"2018-08-17\",\n                \"endDate\": \"2019-05-25\",\n                \"currentMatchday\": null,\n                \"winner\": null\n            },\n            \"numberOfAvailableSeasons\": 2,\n            \"lastUpdated\": \"2019-04-03T23:46:40Z\"\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n### Get specific competition\n\n```js\nfootballData.getCompetition({\n    id: 2021, // Premier League\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"id\": 2021,\n    \"area\": {\n        \"id\": 2072,\n        \"name\": \"England\"\n    },\n    \"name\": \"Premier League\",\n    \"code\": \"PL\",\n    \"emblemUrl\": null,\n    \"plan\": \"TIER_ONE\",\n    \"currentSeason\": {\n        \"id\": 151,\n        \"startDate\": \"2018-08-10\",\n        \"endDate\": \"2019-05-12\",\n        \"currentMatchday\": 33,\n        \"winner\": null\n    },\n    \"seasons\": [\n        {\n            \"id\": 151,\n            \"startDate\": \"2018-08-10\",\n            \"endDate\": \"2019-05-12\",\n            \"currentMatchday\": 33,\n            \"winner\": null\n        },\n        {\n            \"id\": 23,\n            \"startDate\": \"2017-08-11\",\n            \"endDate\": \"2018-05-13\",\n            \"currentMatchday\": 38,\n            \"winner\": {\n                \"id\": 65,\n                \"name\": \"Manchester City FC\",\n                \"shortName\": \"Man City\",\n                \"tla\": \"MCI\",\n                \"crestUrl\": \"https://upload.wikimedia.org/wikipedia/en/e/eb/Manchester_City_FC_badge.svg\"\n            }\n        },\n        ...\n    ],\n    \"lastUpdated\": \"2019-04-06T00:00:38Z\"\n}\n```\n\u003c/details\u003e\n\n### Get teams from competition\n\n```js\nfootballData.getTeamsFromCompetition({\n    competitionId: 2021,\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 20,\n    \"filters\": {},\n    \"competition\": {\n        \"id\": 2021,\n        \"area\": {\n            \"id\": 2072,\n            \"name\": \"England\"\n        },\n        \"name\": \"Premier League\",\n        \"code\": \"PL\",\n        \"plan\": \"TIER_ONE\",\n        \"lastUpdated\": \"2019-04-06T00:00:38Z\"\n    },\n    \"season\": {\n        \"id\": 151,\n        \"startDate\": \"2018-08-10\",\n        \"endDate\": \"2019-05-12\",\n        \"currentMatchday\": 33,\n        \"winner\": null\n    },\n    \"teams\": [\n        {\n            \"id\": 57,\n            \"area\": {\n                \"id\": 2072,\n                \"name\": \"England\"\n            },\n            \"name\": \"Arsenal FC\",\n            \"shortName\": \"Arsenal\",\n            \"tla\": \"ARS\",\n            \"crestUrl\": \"http://upload.wikimedia.org/wikipedia/en/5/53/Arsenal_FC.svg\",\n            \"address\": \"75 Drayton Park London N5 1BU\",\n            \"phone\": \"+44 (020) 76195003\",\n            \"website\": \"http://www.arsenal.com\",\n            \"email\": \"info@arsenal.co.uk\",\n            \"founded\": 1886,\n            \"clubColors\": \"Red / White\",\n            \"venue\": \"Emirates Stadium\",\n            \"lastUpdated\": \"2019-04-04T02:50:20Z\"\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n### Get standings\n```js\nfootballData.getStandingsFromCompetition({\n    competitionId: 2021,\n    standingType: 'TOTAL',\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"filters\": {},\n    \"competition\": {\n        \"id\": 2021,\n        \"area\": {\n            \"id\": 2072,\n            \"name\": \"England\"\n        },\n        \"name\": \"Premier League\",\n        \"code\": \"PL\",\n        \"plan\": \"TIER_ONE\",\n        \"lastUpdated\": \"2019-04-06T00:00:38Z\"\n    },\n    \"season\": {\n        \"id\": 151,\n        \"startDate\": \"2018-08-10\",\n        \"endDate\": \"2019-05-12\",\n        \"currentMatchday\": 33,\n        \"winner\": null\n    },\n    \"standings\": [\n        {\n            \"stage\": \"REGULAR_SEASON\",\n            \"type\": \"TOTAL\",\n            \"group\": null,\n            \"table\": [\n                {\n                    \"position\": 1,\n                    \"team\": {\n                        \"id\": 64,\n                        \"name\": \"Liverpool FC\",\n                        \"crestUrl\": \"http://upload.wikimedia.org/wikipedia/de/0/0a/FC_Liverpool.svg\"\n                    },\n                    \"playedGames\": 33,\n                    \"won\": 25,\n                    \"draw\": 7,\n                    \"lost\": 1,\n                    \"points\": 82,\n                    \"goalsFor\": 75,\n                    \"goalsAgainst\": 20,\n                    \"goalDifference\": 55\n                },\n                {\n                    \"position\": 2,\n                    \"team\": {\n                        \"id\": 65,\n                        \"name\": \"Manchester City FC\",\n                        \"crestUrl\": \"https://upload.wikimedia.org/wikipedia/en/e/eb/Manchester_City_FC_badge.svg\"\n                    },\n                    \"playedGames\": 32,\n                    \"won\": 26,\n                    \"draw\": 2,\n                    \"lost\": 4,\n                    \"points\": 80,\n                    \"goalsFor\": 83,\n                    \"goalsAgainst\": 21,\n                    \"goalDifference\": 62\n                },\n                ...\n            ]\n        }\n    ]\n}\n```\n\u003c/details\u003e\n\n### Get matches from competition\n\n```js\nfootballData.getMatchesFromCompetition({\n    competitionId: 2021,\n    season: 2017,\n    matchday: 12,\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 10,\n    \"filters\": {\n        \"matchday\": \"12\"\n    },\n    \"competition\": {\n        \"id\": 2021,\n        \"area\": {\n            \"id\": 2072,\n            \"name\": \"England\"\n        },\n        \"name\": \"Premier League\",\n        \"code\": \"PL\",\n        \"plan\": \"TIER_ONE\",\n        \"lastUpdated\": \"2019-04-06T00:00:38Z\"\n    },\n    \"matches\": [\n        {\n            \"id\": 205266,\n            \"season\": {\n                \"id\": 23,\n                \"startDate\": \"2017-08-11\",\n                \"endDate\": \"2018-05-13\",\n                \"currentMatchday\": 38\n            },\n            \"utcDate\": \"2017-11-18T12:30:00Z\",\n            \"status\": \"FINISHED\",\n            \"matchday\": 12,\n            \"stage\": \"REGULAR_SEASON\",\n            \"group\": \"Regular Season\",\n            \"lastUpdated\": \"2018-06-22T10:04:00Z\",\n            \"score\": {\n                \"winner\": \"HOME_TEAM\",\n                \"duration\": \"REGULAR\",\n                \"fullTime\": {\n                    \"homeTeam\": 2,\n                    \"awayTeam\": 0\n                },\n                \"halfTime\": {\n                    \"homeTeam\": 2,\n                    \"awayTeam\": 0\n                },\n                \"extraTime\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                },\n                \"penalties\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                }\n            },\n            \"homeTeam\": {\n                \"id\": 57,\n                \"name\": \"Arsenal FC\"\n            },\n            \"awayTeam\": {\n                \"id\": 73,\n                \"name\": \"Tottenham Hotspur FC\"\n            },\n            \"referees\": [\n                {\n                    \"id\": 11575,\n                    \"name\": \"Mike Dean\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 11495,\n                    \"name\": \"Ian Hussin\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 11480,\n                    \"name\": \"Eddie Smart\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 11487,\n                    \"name\": \"Kevin Friend\",\n                    \"nationality\": null\n                }\n            ]\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n\n### Get scorers\n\n```js\nfootballData.getScorersFromCompetition({\n    competitionId: 2002,\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 10,\n    \"filters\": {\n        \"limit\": 10\n    },\n    \"competition\": {\n        \"id\": 2002,\n        \"area\": {\n            \"id\": 2088,\n            \"name\": \"Germany\"\n        },\n        \"name\": \"Bundesliga\",\n        \"code\": \"BL1\",\n        \"plan\": \"TIER_ONE\",\n        \"lastUpdated\": \"2019-04-06T00:00:38Z\"\n    },\n    \"season\": {\n        \"id\": 155,\n        \"startDate\": \"2018-08-24\",\n        \"endDate\": \"2019-05-18\",\n        \"currentMatchday\": 28,\n        \"winner\": null\n    },\n    \"scorers\": [\n        {\n            \"player\": {\n                \"id\": 371,\n                \"name\": \"Robert Lewandowski\",\n                \"firstName\": \"Robert\",\n                \"lastName\": null,\n                \"dateOfBirth\": \"1988-08-21\",\n                \"countryOfBirth\": \"Poland\",\n                \"nationality\": \"Poland\",\n                \"position\": \"Attacker\",\n                \"shirtNumber\": null,\n                \"lastUpdated\": \"2019-04-05T05:12:21Z\"\n            },\n            \"team\": {\n                \"id\": 5,\n                \"name\": \"FC Bayern München\"\n            },\n            \"numberOfGoals\": 19\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n### Get matches\n\n```js\nfootballData.getMatches({\n    dateFrom: '2019-04-01',\n    dateTo: '2019-04-05',\n    competitions: [2021, 2002], // Premier League and Bundesliga\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 8,\n    \"filters\": {\n        \"dateFrom\": \"2019-04-01\",\n        \"dateTo\": \"2019-04-05\",\n        \"permission\": \"TIER_ONE\",\n        \"competitions\": [\n            2021,\n            2002\n        ]\n    },\n    \"matches\": [\n        {\n            \"id\": 233335,\n            \"competition\": {\n                \"id\": 2021,\n                \"name\": \"Premier League\"\n            },\n            \"season\": {\n                \"id\": 151,\n                \"startDate\": \"2018-08-10\",\n                \"endDate\": \"2019-05-12\",\n                \"currentMatchday\": 33,\n                \"winner\": null\n            },\n            \"utcDate\": \"2019-04-01T19:00:00Z\",\n            \"status\": \"FINISHED\",\n            \"matchday\": 32,\n            \"stage\": \"REGULAR_SEASON\",\n            \"group\": \"Regular Season\",\n            \"lastUpdated\": \"2019-04-02T21:35:06Z\",\n            \"score\": {\n                \"winner\": \"HOME_TEAM\",\n                \"duration\": \"REGULAR\",\n                \"fullTime\": {\n                    \"homeTeam\": 2,\n                    \"awayTeam\": 0\n                },\n                \"halfTime\": {\n                    \"homeTeam\": 1,\n                    \"awayTeam\": 0\n                },\n                \"extraTime\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                },\n                \"penalties\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                }\n            },\n            \"homeTeam\": {\n                \"id\": 57,\n                \"name\": \"Arsenal FC\"\n            },\n            \"awayTeam\": {\n                \"id\": 67,\n                \"name\": \"Newcastle United FC\"\n            },\n            \"referees\": [\n                {\n                    \"id\": 11580,\n                    \"name\": \"Anthony Taylor\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 11581,\n                    \"name\": \"Gary Beswick\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 11615,\n                    \"name\": \"Adam Nunn\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 11556,\n                    \"name\": \"David Coote\",\n                    \"nationality\": null\n                }\n            ]\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n### Get specific match\n\n```js\nfootballData.getMatch({\n    id: 233325,\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"head2head\": {\n        \"numberOfMatches\": 10,\n        \"totalGoals\": 17,\n        \"homeTeam\": {\n            \"wins\": 8,\n            \"draws\": 0,\n            \"losses\": 2\n        },\n        \"awayTeam\": {\n            \"wins\": 2,\n            \"draws\": 0,\n            \"losses\": 8\n        }\n    },\n    \"match\": {\n        \"id\": 233325,\n        \"competition\": {\n            \"id\": 2021,\n            \"name\": \"Premier League\"\n        },\n        \"season\": {\n            \"id\": 151,\n            \"startDate\": \"2018-08-10\",\n            \"endDate\": \"2019-05-12\",\n            \"currentMatchday\": 33,\n            \"winner\": null\n        },\n        \"utcDate\": \"2019-04-03T18:45:00Z\",\n        \"status\": \"FINISHED\",\n        \"venue\": \"Tottenham Hotspur Stadium\",\n        \"matchday\": 31,\n        \"stage\": \"REGULAR_SEASON\",\n        \"group\": \"Regular Season\",\n        \"lastUpdated\": \"2019-04-03T23:44:40Z\",\n        \"score\": {\n            \"winner\": \"HOME_TEAM\",\n            \"duration\": \"REGULAR\",\n            \"fullTime\": {\n                \"homeTeam\": 2,\n                \"awayTeam\": 0\n            },\n            \"halfTime\": {\n                \"homeTeam\": 0,\n                \"awayTeam\": 0\n            },\n            \"extraTime\": {\n                \"homeTeam\": null,\n                \"awayTeam\": null\n            },\n            \"penalties\": {\n                \"homeTeam\": null,\n                \"awayTeam\": null\n            }\n        },\n        \"homeTeam\": {\n            \"id\": 73,\n            \"name\": \"Tottenham Hotspur FC\"\n        },\n        \"awayTeam\": {\n            \"id\": 354,\n            \"name\": \"Crystal Palace FC\"\n        },\n        \"referees\": [\n            {\n                \"id\": 11610,\n                \"name\": \"Andre Marriner\",\n                \"nationality\": null\n            },\n            {\n                \"id\": 11611,\n                \"name\": \"Scott Ledger\",\n                \"nationality\": null\n            },\n            {\n                \"id\": 11504,\n                \"name\": \"Simon Long\",\n                \"nationality\": null\n            },\n            {\n                \"id\": 11443,\n                \"name\": \"Chris Kavanagh\",\n                \"nationality\": null\n            }\n        ]\n    }\n}\n```\n\u003c/details\u003e\n\n### Get matches from team\n\n```js\nfootballData.getMatchesFromTeam({\n    teamId: 62, // Everton\n    status: 'SCHEDULED',\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 6,\n    \"filters\": {\n        \"permission\": \"TIER_ONE\",\n        \"status\": [\n            \"SCHEDULED\"\n        ],\n        \"limit\": 100\n    },\n    \"matches\": [\n        {\n            \"id\": 233348,\n            \"competition\": {\n                \"id\": 2021,\n                \"name\": \"Premier League\"\n            },\n            \"season\": {\n                \"id\": 151,\n                \"startDate\": \"2018-08-10\",\n                \"endDate\": \"2019-05-12\",\n                \"currentMatchday\": 33,\n                \"winner\": null\n            },\n            \"utcDate\": \"2019-04-07T13:05:00Z\",\n            \"status\": \"SCHEDULED\",\n            \"matchday\": 33,\n            \"stage\": \"REGULAR_SEASON\",\n            \"group\": \"Regular Season\",\n            \"lastUpdated\": \"2019-04-06T00:00:38Z\",\n            \"score\": {\n                \"winner\": null,\n                \"duration\": \"REGULAR\",\n                \"fullTime\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                },\n                \"halfTime\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                },\n                \"extraTime\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                },\n                \"penalties\": {\n                    \"homeTeam\": null,\n                    \"awayTeam\": null\n                }\n            },\n            \"homeTeam\": {\n                \"id\": 62,\n                \"name\": \"Everton FC\"\n            },\n            \"awayTeam\": {\n                \"id\": 57,\n                \"name\": \"Arsenal FC\"\n            },\n            \"referees\": []\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n### Get specific team\n\n```js\nfootballData.getTeam({\n    id: 86, // Real Madrid\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"id\": 86,\n    \"area\": {\n        \"id\": 2224,\n        \"name\": \"Spain\"\n    },\n    \"activeCompetitions\": [\n        {\n            \"id\": 2001,\n            \"area\": {\n                \"id\": 2077,\n                \"name\": \"Europe\"\n            },\n            \"name\": \"UEFA Champions League\",\n            \"code\": \"CL\",\n            \"plan\": \"TIER_ONE\",\n            \"lastUpdated\": \"2019-03-14T03:25:02Z\"\n        },\n        {\n            \"id\": 2014,\n            \"area\": {\n                \"id\": 2224,\n                \"name\": \"Spain\"\n            },\n            \"name\": \"Primera Division\",\n            \"code\": \"PD\",\n            \"plan\": \"TIER_ONE\",\n            \"lastUpdated\": \"2019-04-06T00:00:38Z\"\n        },\n        {\n            \"id\": 2079,\n            \"area\": {\n                \"id\": 2224,\n                \"name\": \"Spain\"\n            },\n            \"name\": \"Copa del Rey\",\n            \"code\": \"CDR\",\n            \"plan\": \"TIER_THREE\",\n            \"lastUpdated\": \"2019-02-28T23:39:16Z\"\n        }\n    ],\n    \"name\": \"Real Madrid CF\",\n    \"shortName\": \"Real Madrid\",\n    \"tla\": \"RMA\",\n    \"crestUrl\": \"http://upload.wikimedia.org/wikipedia/de/3/3f/Real_Madrid_Logo.svg\",\n    \"address\": \"Avenida Concha Espina, 1 Madrid 28036\",\n    \"phone\": \"+34 (913) 984300\",\n    \"website\": \"http://www.realmadrid.com\",\n    \"email\": \"atencionpublico@corp.realmadrid.com\",\n    \"founded\": 1902,\n    \"clubColors\": \"White / Purple\",\n    \"venue\": \"Estadio Santiago Bernabéu\",\n    \"squad\": [\n        {\n            \"id\": 51,\n            \"name\": \"Keylor Navas\",\n            \"position\": \"Goalkeeper\",\n            \"dateOfBirth\": \"1986-12-15T00:00:00Z\",\n            \"countryOfBirth\": \"Costa Rica\",\n            \"nationality\": \"Costa Rica\",\n            \"shirtNumber\": null,\n            \"role\": \"PLAYER\"\n        },\n        {\n            \"id\": 3641,\n            \"name\": \"Thibaut Courtois\",\n            \"position\": \"Goalkeeper\",\n            \"dateOfBirth\": \"1992-05-11T00:00:00Z\",\n            \"countryOfBirth\": \"Belgium\",\n            \"nationality\": \"Belgium\",\n            \"shirtNumber\": null,\n            \"role\": \"PLAYER\"\n        },\n        {\n            \"id\": 3871,\n            \"name\": \"Luca Zidane\",\n            \"position\": \"Goalkeeper\",\n            \"dateOfBirth\": \"1998-05-13T00:00:00Z\",\n            \"countryOfBirth\": \"France\",\n            \"nationality\": \"France\",\n            \"shirtNumber\": 30,\n            \"role\": \"PLAYER\"\n        },\n        ...\n    ],\n    \"lastUpdated\": \"2019-04-04T02:40:06Z\"\n}\n```\n\u003c/details\u003e\n\n### Get all areas\n\n```js\nfootballData.getAreas().then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 273,\n    \"filters\": {},\n    \"areas\": [\n        {\n            \"id\": 2000,\n            \"name\": \"Afghanistan\",\n            \"countryCode\": \"AFG\",\n            \"ensignUrl\": null,\n            \"parentAreaId\": 2014,\n            \"parentArea\": \"Asia\"\n        },\n        {\n            \"id\": 2001,\n            \"name\": \"Africa\",\n            \"countryCode\": \"AFR\",\n            \"ensignUrl\": null,\n            \"parentAreaId\": 2267,\n            \"parentArea\": \"World\"\n        },\n        {\n            \"id\": 2002,\n            \"name\": \"Albania\",\n            \"countryCode\": \"ALB\",\n            \"ensignUrl\": null,\n            \"parentAreaId\": 2077,\n            \"parentArea\": \"Europe\"\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n### Get specific area\n\n```js\nfootballData.getArea({\n    id: 2072,\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"id\": 2072,\n    \"name\": \"England\",\n    \"countryCode\": \"ENG\",\n    \"ensignUrl\": \"https://upload.wikimedia.org/wikipedia/en/a/ae/Flag_of_the_United_Kingdom.svg\",\n    \"parentAreaId\": 2077,\n    \"parentArea\": \"Europe\",\n    \"childAreas\": []\n}\n```\n\u003c/details\u003e\n\n### Get specific player\n\n```js\nfootballData.getPlayer({\n    id: 2019,\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"id\": 2019,\n    \"name\": \"Gianluigi Buffon\",\n    \"firstName\": \"Gianluigi\",\n    \"lastName\": null,\n    \"dateOfBirth\": \"1978-01-28\",\n    \"countryOfBirth\": \"Italy\",\n    \"nationality\": \"Italy\",\n    \"position\": \"Goalkeeper\",\n    \"shirtNumber\": 1,\n    \"lastUpdated\": \"2019-02-21T05:10:20Z\"\n}\n```\n\u003c/details\u003e\n\n### Get matches from player\n\n```js\nfootballData.getMatchesFromPlayer({\n    playerId: 2019,\n    dateFrom: '2016-01-01',\n    dateTo: '2017-01-01',\n    status: 'FINISHED',\n}).then((data) =\u003e {\n    console.log(JSON.stringify(data, null, 4));\n})\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eResult\u003c/summary\u003e\n\n```json\n{\n    \"count\": 5,\n    \"filters\": {\n        \"permission\": \"TIER_ONE\",\n        \"dateFrom\": \"2016-01-01\",\n        \"dateTo\": \"2017-01-01\",\n        \"status\": [\n            \"FINISHED\"\n        ],\n        \"limit\": 100\n    },\n    \"player\": {\n        \"id\": 2019,\n        \"name\": \"Gianluigi Buffon\",\n        \"firstName\": \"Gianluigi\",\n        \"lastName\": null,\n        \"dateOfBirth\": \"1978-01-28\",\n        \"countryOfBirth\": \"Italy\",\n        \"nationality\": \"Italy\",\n        \"position\": \"Goalkeeper\",\n        \"shirtNumber\": 1,\n        \"lastUpdated\": \"2019-02-21T05:10:20Z\"\n    },\n    \"matches\": [\n        {\n            \"id\": 228574,\n            \"competition\": {\n                \"id\": 2018,\n                \"name\": \"European Championship\"\n            },\n            \"season\": {\n                \"id\": 20,\n                \"startDate\": \"2016-06-10\",\n                \"endDate\": \"2016-07-10\",\n                \"currentMatchday\": 3\n            },\n            \"utcDate\": \"2016-07-02T19:00:00Z\",\n            \"status\": \"FINISHED\",\n            \"matchday\": null,\n            \"stage\": \"QUARTER_FINALS\",\n            \"group\": \"Quarter-finals\",\n            \"lastUpdated\": \"2019-01-11T17:33:45Z\",\n            \"score\": {\n                \"winner\": \"HOME_TEAM\",\n                \"duration\": \"PENALTY_SHOOTOUT\",\n                \"fullTime\": {\n                    \"homeTeam\": 1,\n                    \"awayTeam\": 1\n                },\n                \"halfTime\": {\n                    \"homeTeam\": 0,\n                    \"awayTeam\": 0\n                },\n                \"extraTime\": {\n                    \"homeTeam\": 0,\n                    \"awayTeam\": 0\n                },\n                \"penalties\": {\n                    \"homeTeam\": 6,\n                    \"awayTeam\": 5\n                }\n            },\n            \"homeTeam\": {\n                \"id\": 759,\n                \"name\": \"Germany\"\n            },\n            \"awayTeam\": {\n                \"id\": 784,\n                \"name\": \"Italy\"\n            },\n            \"referees\": [\n                {\n                    \"id\": 43910,\n                    \"name\": \"Viktor Kassai\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 43911,\n                    \"name\": \"György Ring\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 43912,\n                    \"name\": \"Vencel Tóth\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 43888,\n                    \"name\": \"Szymon Marciniak\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 43827,\n                    \"name\": \"Tamás Bognár\",\n                    \"nationality\": null\n                },\n                {\n                    \"id\": 57157,\n                    \"name\": \"Ádám Farkas\",\n                    \"nationality\": null\n                }\n            ]\n        },\n        ...\n    ]\n}\n```\n\u003c/details\u003e\n\n## Testing\n```bash\n$ npm test\n```\n\n## License\n\n**[Mit License]**\n\n[package-url]: https://www.npmjs.com/package/footballdata-api-v2\n[football data]: https://www.football-data.org/\n[football data quickstart]: https://www.football-data.org/documentation/quickstart\n[MIT License]: ./LICENSE.md\n[npm-badge-png]: https://nodei.co/npm/footballdata-api-v2.png?downloads=true\u0026stars=true","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnearhuscarl%2Ffootballdataapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnearhuscarl%2Ffootballdataapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnearhuscarl%2Ffootballdataapi/lists"}