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 9 26/27",
  "season": null,
  "matchday": 9,
  "summary": {
    "matches": 10,
    "goals": 29,
    "own_goals": 0,
    "yellow_cards": 50,
    "second_yellow_cards": 0,
    "red_cards": 2,
    "penalties": "2 from 2",
    "attendance": 336697,
    "average_attendance": 33670,
    "sold_out_matches": 0
  },
  "count": 10,
  "matches": [
    {
      "match_id": 4909730,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909730",
      "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-10-16",
      "time": "9:00 PM",
      "home_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": 8
      },
      "away_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": 9
      },
      "home_goals": 1,
      "away_goals": 1,
      "result": "1:1",
      "note": null
    },
    {
      "match_id": 4909731,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909731",
      "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-10-17",
      "time": "2:00 PM",
      "home_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
      },
      "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": 2
      },
      "home_goals": 0,
      "away_goals": 1,
      "result": "0:1",
      "note": null
    },
    {
      "match_id": 4909737,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909737",
      "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-10-17",
      "time": "4:15 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": 11
      },
      "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": 18
      },
      "home_goals": 0,
      "away_goals": 0,
      "result": "0:0",
      "note": null
    },
    {
      "match_id": 4909728,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909728",
      "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-10-17",
      "time": "6:30 PM",
      "home_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": 3
      },
      "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": 5,
      "result": "2:5",
      "note": null
    },
    {
      "match_id": 4909736,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909736",
      "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-10-17",
      "time": "9:00 PM",
      "home_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": 19
      },
      "away_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": 13
      },
      "home_goals": 0,
      "away_goals": 0,
      "result": "0:0",
      "note": null
    },
    {
      "match_id": 4909734,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909734",
      "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-10-18",
      "time": "2:00 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": 17
      },
      "away_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": 16
      },
      "home_goals": 2,
      "away_goals": 0,
      "result": "2:0",
      "note": null
    },
    {
      "match_id": 4909729,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909729",
      "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-10-18",
      "time": "4:15 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": 10
      },
      "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": 7
      },
      "home_goals": 2,
      "away_goals": 1,
      "result": "2:1",
      "note": null
    },
    {
      "match_id": 4909733,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909733",
      "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-10-18",
      "time": "6:30 PM",
      "home_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": 20
      },
      "away_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": 6
      },
      "home_goals": 2,
      "away_goals": 5,
      "result": "2:5",
      "note": null
    },
    {
      "match_id": 4909735,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909735",
      "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-10-18",
      "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": 4
      },
      "away_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": 5
      },
      "home_goals": 4,
      "away_goals": 1,
      "result": "4:1",
      "note": null
    },
    {
      "match_id": 4909732,
      "link": "https://www.transfermarkt.com/spielbericht/index/spielbericht/4909732",
      "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-10-19",
      "time": "9:00 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": 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": 1,
      "away_goals": 1,
      "result": "1:1",
      "note": null
    }
  ]
}