SofaScore

SofaScore season player statistics table

Returns one page of a football competition season's player statistics table, sortable by a statistic. order chooses the statistic to sort by, direction the sort direction (desc or asc), accumulation whether values are season totals, per-game averages or per-90-minute averages (total, perGame, per90), and group which statistic columns each row carries (summary, attack, defence, passing, goalkeeper). Page with limit (up to 100) and offset; has_next_page shows whether more rows follow. Optional filters narrow the table: team (team ids), nationality (SofaScore nationality codes), position (G, D, M, F), min_appearances and min_minutes; several filters combine (AND) and several values of one filter are alternatives (OR). The team ids and nationality codes of a season come from tournament-statistics-info. A filter that matches nobody returns an empty players list. Other sports return no rows (404). Get id from search and season from tournament-seasons.

get/sofascore/tournament-player-statistics

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/sofascore/tournament-player-statistics
  • Auth: API key in header x-api-key

Query parameters

idstring required

Numeric SofaScore unique-tournament (competition) id of a football competition

seasonstring required

Numeric SofaScore season id

order'rating' | 'goals' | 'expectedGoals' | 'assists' | 'successfulDribbles' | 'tackles' | 'accuratePassesPercentage' | 'bigChancesMissed' | 'totalShots' | 'goalConversionPercentage' | 'interceptions' | 'clearances' | 'errorLeadToGoal' | 'outfielderBlocks' | 'bigChancesCreated' | 'accuratePasses' | 'keyPasses' | 'saves' | 'cleanSheet' | 'penaltySave' | 'savedShotsFromInsideTheBox' | 'runsOut'

Statistic to sort by. Defaults to rating

direction'desc' | 'asc'

Sort direction. Defaults to desc

accumulation'total' | 'perGame' | 'per90'

How statistics are accumulated. Defaults to total

group'summary' | 'attack' | 'defence' | 'passing' | 'goalkeeper'

Statistic columns returned. Defaults to summary

limitinteger

Rows per page, 1 to 100. Defaults to 20

offsetinteger

Rows to skip. Defaults to 0

teamstring[]

Team ids to keep, comma separated, up to 20 (ids from tournament-statistics-info or tournament-teams)

nationalitystring[]

Nationality codes to keep, comma separated, up to 20 (codes from tournament-statistics-info)

positionstring[]

Position codes to keep, comma separated

min_appearancesinteger

Keep players with at least this many appearances, 0 to 1000. Omit for no minimum

min_minutesinteger

Keep players with at least this many minutes played, 0 to 100000. Omit for no minimum

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "accumulation": "total",
    "direction": "desc",
    "group": "summary",
    "limit": 20,
    "order": "rating",
    "page": 1,
    "players": [
      {
        "player": {
          "country": "Spain",
          "id": 855833,
          "name": "Ferran Torres",
          "position": "F",
          "short_name": "F. Torres",
          "slug": "ferran-torres"
        },
        "rank": 1,
        "team": {
          "country": "Spain",
          "id": 2817,
          "name": "FC Barcelona",
          "short_name": "Barcelona",
          "slug": "barcelona"
        }
      }
    ],
    "total_pages": 22
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.