> ## 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. # SofaScore matches of a sport on a day, or live now > Lists a sport's matches from sofascore.com for one day in your time zone (or `live=true` for those in progress), biggest competitions first, as JSON: `id`, `url`, `tournament` (id, name, url, category / country, stage), `season`, `round`, `status` (type notstarted, inprogress, finished, postponed, canceled, with its description such as '2nd half'), `startTime` (ISO, UTC) and `startTimestamp`, `homeTeam` / `awayTeam` (id, name, short name, code, country, url), `homeScore` / `awayScore` (current plus per-period and normal-time scores), `winner`, red cards, seeds and first server (tennis), venue and referee when known. Narrow with `country` (a country or category) or `tournament` (id, link or name), and `status`. Pass a match `id` to `/sports/sofascore-match` for its stats and lineups. Motorsport and cycling are races, not matches, and have no day list. ## OpenAPI ````yaml /api-reference/openapi.json post /sports/sofascore-events 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-events: post: tags: - Plugins summary: SofaScore matches of a sport on a day, or live now description: >- Lists a sport's matches from sofascore.com for one day in your time zone (or `live=true` for those in progress), biggest competitions first, as JSON: `id`, `url`, `tournament` (id, name, url, category / country, stage), `season`, `round`, `status` (type notstarted, inprogress, finished, postponed, canceled, with its description such as '2nd half'), `startTime` (ISO, UTC) and `startTimestamp`, `homeTeam` / `awayTeam` (id, name, short name, code, country, url), `homeScore` / `awayScore` (current plus per-period and normal-time scores), `winner`, red cards, seeds and first server (tennis), venue and referee when known. Narrow with `country` (a country or category) or `tournament` (id, link or name), and `status`. Pass a match `id` to `/sports/sofascore-match` for its stats and lineups. Motorsport and cycling are races, not matches, and have no day list. operationId: sofascore_events_sports_sofascore_events_post parameters: - name: sport in: query required: false schema: type: string 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). default: football 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). - name: date in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Day as YYYY-MM-DD, or today / yesterday / tomorrow (in `timezone`). Default today. title: Date description: >- Day as YYYY-MM-DD, or today / yesterday / tomorrow (in `timezone`). Default today. - name: timezone in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Time zone the day is read in: an IANA name ('Europe/London', 'America/New_York') or a UTC offset ('+02:00'). Default UTC. title: Timezone description: >- Time zone the day is read in: an IANA name ('Europe/London', 'America/New_York') or a UTC offset ('+02:00'). Default UTC. - name: live in: query required: false schema: type: boolean description: true for the matches in progress right now (date is then ignored). default: false title: Live description: true for the matches in progress right now (date is then ignored). - name: status in: query required: false schema: type: string description: 'Keep only: all, live, upcoming, finished.' default: all title: Status description: 'Keep only: all, live, upcoming, finished.' - name: country in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only one country or category, by name, slug, ISO code or id: 'england', 'Spain', 'US', and for tennis 'ATP', 'WTA'. title: Country description: >- Only one country or category, by name, slug, ISO code or id: 'england', 'Spain', 'US', and for tennis 'ATP', 'WTA'. - name: tournament in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only one competition: an id, a sofascore.com tournament link or a name such as 'Premier League' or 'NBA'. title: Tournament description: >- Only one competition: an id, a sofascore.com tournament link or a name such as 'Premier League' or 'NBA'. - name: max_results in: query required: false schema: type: integer description: Matches to return (1-500), the biggest competitions first. default: 100 title: Max Results description: Matches to return (1-500), the biggest competitions first. responses: '200': description: JSON with an `events` array (empty when there are none). content: application/json: schema: {} '400': description: Invalid parameters. '404': description: Unknown country or tournament. '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.