> ## 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 competition with standings and fixtures

> Fetches a competition and season from sofascore.com: `tournament` (name, category / country, tier, title holder and record holders, divisions above and below, dates, followers, url) and `season`, plus the `include` sections: `standings` (every table: position, team, played, won, drawn, lost, scored, conceded, difference, points, promotion or relegation note), `rounds`, `last_matches` (most recent first) and `next_matches` (soonest first) in the events shape, `top_players` and `top_teams` (the top 10 in each statistic, e.g. rating, goals, assists, expected goals) and `seasons` (every season with its id). `tournament` takes an id, a link or a name.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/sofascore-tournament
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-tournament:
    post:
      tags:
        - Plugins
      summary: A SofaScore competition with standings and fixtures
      description: >-
        Fetches a competition and season from sofascore.com: `tournament` (name,
        category / country, tier, title holder and record holders, divisions
        above and below, dates, followers, url) and `season`, plus the `include`
        sections: `standings` (every table: position, team, played, won, drawn,
        lost, scored, conceded, difference, points, promotion or relegation
        note), `rounds`, `last_matches` (most recent first) and `next_matches`
        (soonest first) in the events shape, `top_players` and `top_teams` (the
        top 10 in each statistic, e.g. rating, goals, assists, expected goals)
        and `seasons` (every season with its id). `tournament` takes an id, a
        link or a name.
      operationId: sofascore_tournament_sports_sofascore_tournament_post
      parameters:
        - name: tournament
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              The competition: id (e.g. 17), a sofascore.com tournament link
              (its '#id:' picks the season), or a name such as 'Premier League'
              or 'NBA' (best search match).
            title: Tournament
          description: >-
            The competition: id (e.g. 17), a sofascore.com tournament link (its
            '#id:' picks the season), or a name such as 'Premier League' or
            'NBA' (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: season
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              A season id or its year as SofaScore writes it ('26/27', '2026').
              Default the current one.
            title: Season
          description: >-
            A season id or its year as SofaScore writes it ('26/27', '2026').
            Default the current one.
        - name: include
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Sections to add, comma separated: seasons, standings, rounds,
              last_matches, next_matches, top_players, top_teams (or all /
              none). Default standings,last_matches,next_matches.
            title: Include
          description: >-
            Sections to add, comma separated: seasons, standings, rounds,
            last_matches, next_matches, top_players, top_teams (or all / none).
            Default standings,last_matches,next_matches.
      responses:
        '200':
          description: JSON with the `tournament`, `season` and the asked-for sections.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: No such competition or season.
        '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.