> ## 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.

# Get a FotMob league table, fixtures and top players

> Returns one football competition: `table` (a list with one block per league table, conference or cup group, each with `rows` carrying `position`, `team`, `played`, `wins`, `draws`, `losses`, `goalsFor`, `goalsAgainst`, `goalDifference`, `points`, `xG`, `form` and `qualification`, plus `home` and `away` splits), `fixtures` for the whole season (`round`, `startTime`, `status`, `home` and `away` with scores once played, `url`), `topPlayers` and `topTeams` per stat category, `playoff` for knockout brackets, and `availableSeasons`. A league without a table or fixtures yet returns empty lists with a `message`.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/fotmob-league
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/fotmob-league:
    post:
      tags:
        - Plugins
      summary: Get a FotMob league table, fixtures and top players
      description: >-
        Returns one football competition: `table` (a list with one block per
        league table, conference or cup group, each with `rows` carrying
        `position`, `team`, `played`, `wins`, `draws`, `losses`, `goalsFor`,
        `goalsAgainst`, `goalDifference`, `points`, `xG`, `form` and
        `qualification`, plus `home` and `away` splits), `fixtures` for the
        whole season (`round`, `startTime`, `status`, `home` and `away` with
        scores once played, `url`), `topPlayers` and `topTeams` per stat
        category, `playoff` for knockout brackets, and `availableSeasons`. A
        league without a table or fixtures yet returns empty lists with a
        `message`.
      operationId: fotmob_league_sports_fotmob_league_post
      parameters:
        - name: league
          in: query
          required: true
          schema:
            type: string
            description: >-
              A FotMob league id (47 is the Premier League) or a
              fotmob.com/leagues/... link.
            title: League
          description: >-
            A FotMob league id (47 is the Premier League) or a
            fotmob.com/leagues/... link.
        - name: season
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              A season as FotMob writes it, e.g. '2024/2025' or '2026'. Leave
              blank for the current one; `availableSeasons` lists them.
            title: Season
          description: >-
            A season as FotMob writes it, e.g. '2024/2025' or '2026'. Leave
            blank for the current one; `availableSeasons` lists them.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'GB', 'DE').
              Leave blank to let the API pick.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'GB', 'DE').
            Leave blank to let the API pick.
      responses:
        '200':
          description: JSON with `table` and `fixtures`.
          content:
            application/json:
              schema: {}
        '400':
          description: >-
            `league` is not a FotMob league, `season` is malformed, or the proxy
            country is invalid.
        '404':
          description: FotMob has no such league.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked, no league data on the page, or the call did not finish 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
      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.