Transfermarkt Scraper

ENDPOINTS
GET/players/upcoming-matches

Player Upcoming Matches

The player's next fixtures for club and country with kick-off time, competition and matchday.

QUERY PARAMS

Transfermarkt player ID or any transfermarkt.com player URL.

Examples:

  • ID: 28003
  • URL: https://www.transfermarkt.com/lionel-messi/profil/spieler/28003

How many upcoming matches to return.

Default: 10

Allowed values: 1-50

{
  "player_id": 28003,
  "count": 4,
  "matches": [
    {
      "id": 5053405,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/5053405",
      "datetime_utc": "2026-10-24T20:30:00Z",
      "competition": {
        "id": "MLS1",
        "name": "MLS",
        "link": "https://www.transfermarkt.com/major-league-soccer/startseite/wettbewerb/MLS1"
      },
      "matchday": 32,
      "group": null,
      "home_club": {
        "id": 623,
        "name": "New York",
        "link": "https://www.transfermarkt.com/new-york-red-bulls/startseite/verein/623",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/623.png?lm=1789459204",
        "is_national_team": false
      },
      "away_club": {
        "id": 69261,
        "name": "Miami",
        "link": "https://www.transfermarkt.com/inter-miami-cf/startseite/verein/69261",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/69261.png?lm=1789463707",
        "is_national_team": false
      },
      "result": null,
      "status": "fixture",
      "player_is_injured": false,
      "player_is_suspended": false
    },
    {
      "id": 5053419,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/5053419",
      "datetime_utc": "2026-10-28T23:30:00Z",
      "competition": {
        "id": "MLS1",
        "name": "MLS",
        "link": "https://www.transfermarkt.com/major-league-soccer/startseite/wettbewerb/MLS1"
      },
      "matchday": 33,
      "group": null,
      "home_club": {
        "id": 69261,
        "name": "Miami",
        "link": "https://www.transfermarkt.com/inter-miami-cf/startseite/verein/69261",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/69261.png?lm=1789463707",
        "is_national_team": false
      },
      "away_club": {
        "id": 51772,
        "name": "Cincinnati",
        "link": "https://www.transfermarkt.com/fc-cincinnati/startseite/verein/51772",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/51772.png?lm=1789462422",
        "is_national_team": false
      },
      "result": null,
      "status": "fixture",
      "player_is_injured": false,
      "player_is_suspended": false
    },
    {
      "id": 5053454,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/5053454",
      "datetime_utc": "2026-11-02T00:00:00Z",
      "competition": {
        "id": "MLS1",
        "name": "MLS",
        "link": "https://www.transfermarkt.com/major-league-soccer/startseite/wettbewerb/MLS1"
      },
      "matchday": 34,
      "group": null,
      "home_club": {
        "id": 626,
        "name": "New England",
        "link": "https://www.transfermarkt.com/new-england-revolution/startseite/verein/626",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/626.png?lm=1789459205",
        "is_national_team": false
      },
      "away_club": {
        "id": 69261,
        "name": "Miami",
        "link": "https://www.transfermarkt.com/inter-miami-cf/startseite/verein/69261",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/69261.png?lm=1789463707",
        "is_national_team": false
      },
      "result": null,
      "status": "fixture",
      "player_is_injured": false,
      "player_is_suspended": false
    },
    {
      "id": 5053469,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/5053469",
      "datetime_utc": "2026-11-07T21:00:00Z",
      "competition": {
        "id": "MLS1",
        "name": "MLS",
        "link": "https://www.transfermarkt.com/major-league-soccer/startseite/wettbewerb/MLS1"
      },
      "matchday": 35,
      "group": null,
      "home_club": {
        "id": 69261,
        "name": "Miami",
        "link": "https://www.transfermarkt.com/inter-miami-cf/startseite/verein/69261",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/69261.png?lm=1789463707",
        "is_national_team": false
      },
      "away_club": {
        "id": 78435,
        "name": "Charlotte",
        "link": "https://www.transfermarkt.com/charlotte-fc/startseite/verein/78435",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/78435.png?lm=1789471579",
        "is_national_team": false
      },
      "result": null,
      "status": "fixture",
      "player_is_injured": false,
      "player_is_suspended": false
    }
  ]
}