Transfermarkt Scraper

ENDPOINTS
GET/competitions/matchday

Competition Matchday

All matches of one matchday with scores, match IDs and the matchday summary.

QUERY PARAMS

Transfermarkt competition code (GB1 Premier League, ES1 LaLiga, L1 Bundesliga, IT1 Serie A, FR1 Ligue 1, CL Champions League) or any transfermarkt.com competition URL.

Examples:

  • Code: ES1
  • URL: https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1

Matchday number.

Default: the current matchday

Allowed values: 1-99

Season start year or name — 2025, 25/26 and 2025/26 all mean the 2025/26 season.

Default: the current season

{
  "competition_id": "ES1",
  "title": "Matchday 5 26/27",
  "season": null,
  "matchday": 5,
  "summary": {
    "matches": 10,
    "goals": 29,
    "own_goals": 0,
    "yellow_cards": 32,
    "second_yellow_cards": 0,
    "red_cards": 1,
    "penalties": "4 from 4",
    "attendance": 312279,
    "average_attendance": 31228,
    "sold_out_matches": 0
  },
  "count": 10,
  "matches": [
    {
      "match_id": 4909532,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909532",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-11",
      "time": "9:00 PM",
      "home_club": {
        "id": 368,
        "name": "Sevilla FC",
        "link": "https://www.transfermarkt.com/fc-sevilla/startseite/verein/368",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/368.png?lm=1789459189",
        "table_position": 7
      },
      "away_club": {
        "id": 1049,
        "name": "Valencia CF",
        "link": "https://www.transfermarkt.com/fc-valencia/startseite/verein/1049",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/1049.png?lm=1789459228",
        "table_position": 20
      },
      "home_goals": 1,
      "away_goals": 0,
      "result": "1:0",
      "note": null
    },
    {
      "match_id": 4909529,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909529",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-12",
      "time": "2:00 PM",
      "home_club": {
        "id": 630,
        "name": "Racing Santander",
        "link": "https://www.transfermarkt.com/racing-santander/startseite/verein/630",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/630.png?lm=1789459205",
        "table_position": 13
      },
      "away_club": {
        "id": 1108,
        "name": "Deportivo Alavés",
        "link": "https://www.transfermarkt.com/deportivo-alaves/startseite/verein/1108",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/1108.png?lm=1789459235",
        "table_position": 2
      },
      "home_goals": 2,
      "away_goals": 1,
      "result": "2:1",
      "note": null
    },
    {
      "match_id": 4909528,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909528",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-12",
      "time": "4:15 PM",
      "home_club": {
        "id": 331,
        "name": "CA Osasuna",
        "link": "https://www.transfermarkt.com/ca-osasuna/startseite/verein/331",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/331.png?lm=1789459184",
        "table_position": 8
      },
      "away_club": {
        "id": 714,
        "name": "RCD Espanyol Barcelona",
        "link": "https://www.transfermarkt.com/espanyol-barcelona/startseite/verein/714",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/714.png?lm=1789459206",
        "table_position": 12
      },
      "home_goals": 0,
      "away_goals": 2,
      "result": "0:2",
      "note": null
    },
    {
      "match_id": 4909524,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909524",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-12",
      "time": "6:30 PM",
      "home_club": {
        "id": 621,
        "name": "Athletic Bilbao",
        "link": "https://www.transfermarkt.com/athletic-bilbao/startseite/verein/621",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/621.png?lm=1789459204",
        "table_position": 9
      },
      "away_club": {
        "id": 1531,
        "name": "Elche CF",
        "link": "https://www.transfermarkt.com/fc-elche/startseite/verein/1531",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/1531.png?lm=1789459258",
        "table_position": 19
      },
      "home_goals": 1,
      "away_goals": 1,
      "result": "1:1",
      "note": null
    },
    {
      "match_id": 4909530,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909530",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-12",
      "time": "9:00 PM",
      "home_club": {
        "id": 418,
        "name": "Real Madrid",
        "link": "https://www.transfermarkt.com/real-madrid/startseite/verein/418",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/418.png?lm=1789459190",
        "table_position": 3
      },
      "away_club": {
        "id": 367,
        "name": "Rayo Vallecano",
        "link": "https://www.transfermarkt.com/rayo-vallecano/startseite/verein/367",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/367.png?lm=1789459189",
        "table_position": 14
      },
      "home_goals": 4,
      "away_goals": 1,
      "result": "4:1",
      "note": null
    },
    {
      "match_id": 4909525,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909525",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-13",
      "time": "2:00 PM",
      "home_club": {
        "id": 940,
        "name": "Celta de Vigo",
        "link": "https://www.transfermarkt.com/celta-vigo/startseite/verein/940",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/940.png?lm=1789459221",
        "table_position": 17
      },
      "away_club": {
        "id": 1084,
        "name": "Málaga CF",
        "link": "https://www.transfermarkt.com/fc-malaga/startseite/verein/1084",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/1084.png?lm=1789459229",
        "table_position": 18
      },
      "home_goals": 1,
      "away_goals": 1,
      "result": "1:1",
      "note": null
    },
    {
      "match_id": 4909527,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909527",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-13",
      "time": "4:15 PM",
      "home_club": {
        "id": 3368,
        "name": "Levante UD",
        "link": "https://www.transfermarkt.com/ud-levante/startseite/verein/3368",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/3368.png?lm=1789459344",
        "table_position": 11
      },
      "away_club": {
        "id": 131,
        "name": "FC Barcelona",
        "link": "https://www.transfermarkt.com/fc-barcelona/startseite/verein/131",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/131.png?lm=1789459175",
        "table_position": 1
      },
      "home_goals": 2,
      "away_goals": 4,
      "result": "2:4",
      "note": null
    },
    {
      "match_id": 4909526,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909526",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-13",
      "time": "6:30 PM",
      "home_club": {
        "id": 3709,
        "name": "Getafe CF",
        "link": "https://www.transfermarkt.com/fc-getafe/startseite/verein/3709",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/3709.png?lm=1789459359",
        "table_position": 15
      },
      "away_club": {
        "id": 897,
        "name": "Deportivo A Coruña",
        "link": "https://www.transfermarkt.com/deportivo-la-coruna/startseite/verein/897",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/897.png?lm=1789459220",
        "table_position": 5
      },
      "home_goals": 1,
      "away_goals": 1,
      "result": "1:1",
      "note": null
    },
    {
      "match_id": 4909531,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909531",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-13",
      "time": "9:00 PM",
      "home_club": {
        "id": 681,
        "name": "Real Sociedad",
        "link": "https://www.transfermarkt.com/real-sociedad-san-sebastian/startseite/verein/681",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/681.png?lm=1789459206",
        "table_position": 10
      },
      "away_club": {
        "id": 13,
        "name": "Atlético de Madrid",
        "link": "https://www.transfermarkt.com/atletico-madrid/startseite/verein/13",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/13.png?lm=1789030932",
        "table_position": 6
      },
      "home_goals": 0,
      "away_goals": 3,
      "result": "0:3",
      "note": null
    },
    {
      "match_id": 4909533,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909533",
      "competition": {
        "id": "ES1",
        "name": "LaLiga",
        "link": "https://www.transfermarkt.com/laliga/startseite/wettbewerb/ES1",
        "logo": "https://img.a.transfermarkt.technology/logo/medium/es1.png?lm=1789377130"
      },
      "date": "2026-09-14",
      "time": "9:00 PM",
      "home_club": {
        "id": 1050,
        "name": "Villarreal CF",
        "link": "https://www.transfermarkt.com/fc-villarreal/startseite/verein/1050",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/1050.png?lm=1789459228",
        "table_position": 16
      },
      "away_club": {
        "id": 150,
        "name": "Real Betis Balompié",
        "link": "https://www.transfermarkt.com/real-betis-sevilla/startseite/verein/150",
        "crest": "https://img.a.transfermarkt.technology/wappen/head/150.png?lm=1789459175",
        "table_position": 4
      },
      "home_goals": 1,
      "away_goals": 2,
      "result": "1:2",
      "note": null
    }
  ]
}