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

# Scrape a Flashscore match: details, statistics, lineups and odds

> Reads one Flashscore match and returns `competition`, `startTime`, `status`, `home` and `away` with `score`, `winner`, `periods`, `venue`, `referee`, `attendance`, `incidents` (goals, cards, substitutions with minute and player), `statistics` by group, `lineups` (starters, substitutes, missing players, coaches) and `odds`: for each market and scope, every bookmaker's `prices` with `value`, `opening` and, once settled, `result`. Sections Flashscore does not hold for a match are left out, and any that could not be loaded are named in `unavailable`. Odds vary by country of the bookmakers; set `odds_region`.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/flashscore-match
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/flashscore-match:
    post:
      tags:
        - Plugins
      summary: 'Scrape a Flashscore match: details, statistics, lineups and odds'
      description: >-
        Reads one Flashscore match and returns `competition`, `startTime`,
        `status`, `home` and `away` with `score`, `winner`, `periods`, `venue`,
        `referee`, `attendance`, `incidents` (goals, cards, substitutions with
        minute and player), `statistics` by group, `lineups` (starters,
        substitutes, missing players, coaches) and `odds`: for each market and
        scope, every bookmaker's `prices` with `value`, `opening` and, once
        settled, `result`. Sections Flashscore does not hold for a match are
        left out, and any that could not be loaded are named in `unavailable`.
        Odds vary by country of the bookmakers; set `odds_region`.
      operationId: flashscore_match_sports_flashscore_match_post
      parameters:
        - name: match
          in: query
          required: true
          schema:
            type: string
            description: >-
              A Flashscore match link or id, as returned in `matches[].url` from
              `/sports/flashscore-matches`.
            title: Match
          description: >-
            A Flashscore match link or id, as returned in `matches[].url` from
            `/sports/flashscore-matches`.
        - name: odds_region
          in: query
          required: false
          schema:
            type: string
            description: ISO-2 country whose bookmakers the odds come from.
            default: GB
            title: Odds Region
          description: ISO-2 country whose bookmakers the odds come from.
        - 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 the match and its sections.
          content:
            application/json:
              schema: {}
        '400':
          description: >-
            `match` is not a Flashscore match, `odds_region` is invalid, or the
            proxy country is invalid.
        '404':
          description: Flashscore has no match at this address.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked, no match on that 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.