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

# Search SofaScore teams, players, tournaments and matches

> Searches sofascore.com for `query` and returns the matches as JSON, best first. Each result has `rank` (its place in the list), `type` (team, player, tournament, match, manager, referee or venue), `id`, `name`, `slug`, a sofascore.com `url`, `sport`, `country` and `followers`; a player adds `position`, `jerseyNumber` and its `team`, a tournament its `category`, a match the same fields as `/sports/sofascore-events`. `sport` keeps to one sport, `type` to one kind of result. Feed an `id` to `/sports/sofascore-team`, `-player`, `-tournament` or `-match`.



## OpenAPI

````yaml /api-reference/openapi.json post /sports/sofascore-search
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-search:
    post:
      tags:
        - Plugins
      summary: Search SofaScore teams, players, tournaments and matches
      description: >-
        Searches sofascore.com for `query` and returns the matches as JSON, best
        first. Each result has `rank` (its place in the list), `type` (team,
        player, tournament, match, manager, referee or venue), `id`, `name`,
        `slug`, a sofascore.com `url`, `sport`, `country` and `followers`; a
        player adds `position`, `jerseyNumber` and its `team`, a tournament its
        `category`, a match the same fields as `/sports/sofascore-events`.
        `sport` keeps to one sport, `type` to one kind of result. Feed an `id`
        to `/sports/sofascore-team`, `-player`, `-tournament` or `-match`.
      operationId: sofascore_search_sports_sofascore_search_post
      parameters:
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              What to look for: a team, player, competition, match, manager,
              referee or venue name, e.g. 'real madrid', 'sinner', 'premier
              league', 'arsenal chelsea'.
            title: Query
          description: >-
            What to look for: a team, player, competition, match, manager,
            referee or venue name, e.g. 'real madrid', 'sinner', 'premier
            league', 'arsenal chelsea'.
        - 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: type
          in: query
          required: false
          schema:
            type: string
            description: >-
              Kind of result: all, teams, players, tournaments, matches,
              managers, referees, venues (all mixes them, best match first).
            default: all
            title: Type
          description: >-
            Kind of result: all, teams, players, tournaments, matches, managers,
            referees, venues (all mixes them, best match first).
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: >-
              1-based results page to start from (1-5); the site serves 20 per
              page.
            default: 1
            title: Page
          description: >-
            1-based results page to start from (1-5); the site serves 20 per
            page.
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: Results to collect across pages (1-100).
            default: 20
            title: Max Results
          description: Results to collect across pages (1-100).
      responses:
        '200':
          description: JSON with a `results` array (empty when nothing matched).
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '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.