> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# A SofaScore player with season stats and matches

> Fetches a player from sofascore.com: `player` (name, team, position and detailed positions, shirt number, birth date, height, preferred foot, country, market value, contract end, followers, url) plus the `include` sections: `season_stats` (every statistic SofaScore keeps for one competition and season, e.g. rating, goals, expected goals, assists, passes, duels, saves), `seasons` (each competition with its seasons, to pick `tournament` and `season`), `last_matches` (most recent first, with the player's rating, minutes and goals or assists in each), `transfers`, `attributes` (attacking, technical, tactical, defending, creativity scores) and `national_team` (caps, goals, debut). `player` takes an id, a link or a name.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/sofascore-player
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /sports/sofascore-player:
    post:
      tags:
        - Plugins
      summary: A SofaScore player with season stats and matches
      description: >-
        Fetches a player from sofascore.com: `player` (name, team, position and
        detailed positions, shirt number, birth date, height, preferred foot,
        country, market value, contract end, followers, url) plus the `include`
        sections: `season_stats` (every statistic SofaScore keeps for one
        competition and season, e.g. rating, goals, expected goals, assists,
        passes, duels, saves), `seasons` (each competition with its seasons, to
        pick `tournament` and `season`), `last_matches` (most recent first, with
        the player's rating, minutes and goals or assists in each), `transfers`,
        `attributes` (attacking, technical, tactical, defending, creativity
        scores) and `national_team` (caps, goals, debut). `player` takes an id,
        a link or a name.
      operationId: sofascore_player_sports_sofascore_player_post
      parameters:
        - name: player
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              The player: id (e.g. 12994), a sofascore.com player link, or a
              name such as 'Lionel Messi' (best search match).
            title: Player
          description: >-
            The player: id (e.g. 12994), a sofascore.com player link, or a name
            such as 'Lionel Messi' (best search match).
        - name: sport
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              The sport: football, basketball, tennis, ice-hockey,
              american-football, baseball, handball, volleyball, cricket, rugby,
              futsal, table-tennis, esports, darts, snooker, mma, aussie-rules,
              waterpolo, floorball, bandy, badminton, beach-volley,
              minifootball, padel, motorsport, cycling (soccer, hockey, nba, nfl
              and the like are accepted). Optional; narrows the search or name
              lookup to one sport.
            title: Sport
          description: >-
            The sport: football, basketball, tennis, ice-hockey,
            american-football, baseball, handball, volleyball, cricket, rugby,
            futsal, table-tennis, esports, darts, snooker, mma, aussie-rules,
            waterpolo, floorball, bandy, badminton, beach-volley, minifootball,
            padel, motorsport, cycling (soccer, hockey, nba, nfl and the like
            are accepted). Optional; narrows the search or name lookup to one
            sport.
        - name: include
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Sections to add, comma separated: seasons, season_stats,
              last_matches, transfers, attributes, national_team (or all /
              none). Default season_stats,last_matches.
            title: Include
          description: >-
            Sections to add, comma separated: seasons, season_stats,
            last_matches, transfers, attributes, national_team (or all / none).
            Default season_stats,last_matches.
        - name: tournament
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              For season_stats: the competition id (see the seasons section).
              Default the player's first listed competition.
            title: Tournament
          description: >-
            For season_stats: the competition id (see the seasons section).
            Default the player's first listed competition.
        - name: season
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              For season_stats: a season id or its year as SofaScore writes it
              ('26/27', '2026'). Default the latest.
            title: Season
          description: >-
            For season_stats: a season id or its year as SofaScore writes it
            ('26/27', '2026'). Default the latest.
      responses:
        '200':
          description: JSON with the `player` and the asked-for sections.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: No such player.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: SofaScore refused every attempt or did not answer in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.