---
title: "SofaScore player attributes and characteristics"
method: GET
path: "/sofascore/player-attributes"
tags: ["SofaScore"]
---

# SofaScore player attributes and characteristics

`GET /sofascore/player-attributes`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/player-attributes`
- Auth: API key in header `x-api-key`

Returns a football player's attribute scores (0 to 100) for the current year and up to three earlier years (`year_shift` 0 to 3), the average scores for the player's position, and the player's characteristics: playing positions plus strengths and weaknesses, each with SofaScore's numeric `code`, a `key` and `name` such as finishing or aerial duels, and a `rank`. Outfield players carry attacking, technical, tactical, defending and creativity scores; goalkeepers carry saves, anticipation, ball_distribution, aerial and tactical. Combines two SofaScore requests. Returns 404 for players without attribute overviews, which includes non-football players.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascorePlayerAttributesResponseDoc
  - `code` integer
  - `data` SofascorePlayerAttributesResponse
    - `characteristics` SofascorePlayerCharacteristics
      - `positions` string[]
      - `strengths` SofascorePlayerCharacteristic[]
        - `code` integer: Code is SofaScore's numeric characteristic code.
        - `key` string: Key is the identifier the SofaScore web client uses for the code (for example finishing); omitted for a code the client does not name.
        - `name` string
        - `rank` integer: Rank is SofaScore's rank value for the characteristic.
      - `weaknesses` SofascorePlayerCharacteristic[]
        - `code` integer: Code is SofaScore's numeric characteristic code.
        - `key` string: Key is the identifier the SofaScore web client uses for the code (for example finishing); omitted for a code the client does not name.
        - `name` string
        - `rank` integer: Rank is SofaScore's rank value for the characteristic.
    - `characteristics_url` string
    - `fetched_at` string
    - `overviews` SofascorePlayerAttributeOverview[]
      - `attributes` object
      - `position` string
      - `year_shift` integer: YearShift is 0 for the current scores and N for the scores N years earlier.
    - `player_id` integer
    - `position_averages` SofascorePlayerAttributeOverview[]
      - `attributes` object
      - `position` string
      - `year_shift` integer: YearShift is 0 for the current scores and N for the scores N years earlier.
    - `source_url` string
    - `sport` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)