Sofascore Scraper

ENDPOINTS
GET/matches/details

Match Details

Full match card: teams, managers, scores by period, status, winner, venue, referee, attendance and coverage flags.

QUERY PARAMS

Sofascore match id or any sofascore.com match URL (the #id: fragment is the id).

Examples:

  • ID: 14023961
  • URL: https://www.sofascore.com/football/match/…#id:14023961
{
  "match": {
    "id": 14023961,
    "custom_id": "rP",
    "slug": "aston-villa-manchester-city",
    "link": "https://www.sofascore.com/football/match/aston-villa-manchester-city/rP#id:14023961",
    "start_time": "2026-05-24T15:00:00Z",
    "status": {
      "code": 100,
      "type": "finished",
      "description": "Ended"
    },
    "is_live": false,
    "is_finished": true,
    "winner_code": 2,
    "home_team": {
      "id": 17,
      "name": "Manchester City",
      "short_name": "Man City",
      "code": "MCI",
      "slug": "manchester-city",
      "link": "https://www.sofascore.com/team/football/manchester-city/17",
      "image_link": "https://img.sofascore.com/api/v1/team/17/image",
      "sport": {
        "id": 1,
        "name": "Football",
        "slug": "football"
      },
      "country": {
        "name": "England",
        "alpha2": "EN",
        "alpha3": "ENG",
        "slug": "england"
      },
      "gender": "M",
      "is_national": false,
      "colors": {
        "primary": "#66ccff",
        "secondary": "#ffffff",
        "text": "#ffffff"
      },
      "followers_count": 4747370,
      "founded_date": "1880-11-23",
      "manager": {
        "id": 794873,
        "name": "Enzo Maresca",
        "short_name": "E. Maresca",
        "slug": "enzo-maresca",
        "link": "https://www.sofascore.com/manager/enzo-maresca/794873",
        "image_link": "https://img.sofascore.com/api/v1/manager/794873/image",
        "country": {
          "name": "Italy",
          "alpha2": "IT",
          "alpha3": "ITA",
          "slug": "italy"
        }
      },
      "venue": {
        "id": 606,
        "name": "Etihad Stadium",
        "slug": "etihad-stadium",
        "capacity": 53400,
        "city": "Manchester",
        "country": {
          "name": "England",
          "alpha2": "EN",
          "alpha3": "ENG",
          "slug": "england"
        },
        "coordinates": {
          "latitude": 53.483091,
          "longitude": -2.200252
        }
      }
    },
    "away_team": {
      "id": 40,
      "name": "Aston Villa",
      "short_name": "Aston Villa",
      "code": "AVL",
      "slug": "aston-villa",
      "link": "https://www.sofascore.com/team/football/aston-villa/40",
      "image_link": "https://img.sofascore.com/api/v1/team/40/image",
      "sport": {
        "id": 1,
        "name": "Football",
        "slug": "football"
      },
      "country": {
        "name": "England",
        "alpha2": "EN",
        "alpha3": "ENG",
        "slug": "england"
      },
      "gender": "M",
      "is_national": false,
      "colors": {
        "primary": "#670e36",
        "secondary": "#94bee5",
        "text": "#94bee5"
      },
      "followers_count": 1090431,
      "founded_date": "1874-03-01",
      "manager": {
        "id": 53062,
        "name": "Unai Emery",
        "short_name": "U. Emery",
        "slug": "unai-emery",
        "link": "https://www.sofascore.com/manager/unai-emery/53062",
        "image_link": "https://img.sofascore.com/api/v1/manager/53062/image",
        "country": {
          "name": "Spain",
          "alpha2": "ES",
          "alpha3": "ESP",
          "slug": "spain"
        }
      },
      "venue": {
        "id": 815,
        "name": "Villa Park",
        "slug": "villa-park",
        "capacity": 42640,
        "city": "Birmingham",
        "country": {
          "name": "England",
          "alpha2": "EN",
          "alpha3": "ENG",
          "slug": "england"
        },
        "coordinates": {
          "latitude": 52.509126,
          "longitude": -1.885035
        }
      }
    },
    "home_score": {
      "current": 1,
      "display": 1,
      "periods": {
        "period1": 1,
        "period2": 0,
        "normaltime": 1
      }
    },
    "away_score": {
      "current": 2,
      "display": 2,
      "periods": {
        "period1": 0,
        "period2": 2,
        "normaltime": 2
      }
    },
    "round": {
      "number": 38,
      "name": null,
      "slug": null,
      "cup_round_type": null
    },
    "tournament": {
      "id": 17,
      "name": "Premier League",
      "slug": "premier-league",
      "link": "https://www.sofascore.com/tournament/football/england/premier-league/17",
      "image_link": "https://img.sofascore.com/api/v1/unique-tournament/17/image",
      "dark_image_link": "https://img.sofascore.com/api/v1/unique-tournament/17/image/dark",
      "colors": {
        "primary": "#3c1c5a",
        "secondary": "#f80158"
      },
      "has_rounds": true,
      "followers_count": 1355677,
      "category": {
        "id": 1,
        "name": "England",
        "slug": "england",
        "link": "https://www.sofascore.com/football/england",
        "sport": {
          "id": 1,
          "name": "Football",
          "slug": "football"
        },
        "country": {
          "name": "England",
          "alpha2": "EN",
          "alpha3": "ENG",
          "slug": "england"
        },
        "flag_image_link": "https://img.sofascore.com/api/v1/country/EN/flag"
      },
      "has_player_statistics": true,
      "group": null,
      "is_live": false
    },
    "season": {
      "id": 76986,
      "name": "Premier League 25/26",
      "year": "25/26"
    },
    "time": {
      "injury_time1": 3,
      "injury_time2": 10,
      "current_period_start_time": "2026-05-24T16:05:15Z"
    },
    "venue": {
      "id": 606,
      "name": "Etihad Stadium",
      "slug": "etihad-stadium",
      "capacity": 53400,
      "city": "Manchester",
      "country": {
        "name": "England",
        "alpha2": "EN",
        "alpha3": "ENG",
        "slug": "england"
      },
      "coordinates": {
        "latitude": 53.483091,
        "longitude": -2.200252
      }
    },
    "referee": {
      "id": 79884,
      "name": "Andy Madley",
      "slug": "andy-madley",
      "link": "https://www.sofascore.com/referee/andy-madley/79884",
      "country": {
        "name": "England",
        "alpha2": "EN",
        "alpha3": "ENG",
        "slug": "england"
      },
      "sport": {
        "id": 1,
        "name": "Football",
        "slug": "football"
      },
      "career": {
        "games": 462,
        "yellow_cards": 1440,
        "red_cards": 36,
        "second_yellow_cards": 16
      }
    },
    "attendance": 60332,
    "format": {
      "period_count": 2,
      "period_length_minutes": 45,
      "overtime_length_minutes": 15
    },
    "has_highlights": true,
    "has_xg": true,
    "has_player_statistics": true,
    "has_player_heatmap": true,
    "is_final_result_only": false
  }
}