{
  "openapi": "3.0.1",
  "info": {
    "title": "🚀 Sofascore Scraper · 5,000 Free Matches/Month",
    "description": "Sofascore Scraper gets you Sofascore matches ⚡ fast, 🎯 100% accurate and 🔍 ridiculously detailed — live scores, fixtures & results for 26 sports, with full stats, lineups & incidents on demand. 💰 $1 per 1,000 matches, no start fee. Scrape your first 5,000 matches free every month 🚀",
    "version": "0.0",
    "x-build-id": "TsarBOj5qI59T8hbo"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/omkar-cloud~sofascore-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-omkar-cloud-sofascore-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/omkar-cloud~sofascore-scraper/runs": {
      "post": {
        "operationId": "runs-sync-omkar-cloud-sofascore-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/omkar-cloud~sofascore-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-omkar-cloud-sofascore-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "sports": {
            "title": "Sports",
            "type": "array",
            "description": "Sport slugs to search, one per entry: `football`, `tennis`, `basketball`, `ice-hockey`, `volleyball`, `handball`, `baseball`, `american-football`, `rugby`, `cricket`, `table-tennis`, `esports`, `mma`, `motorsport`, `darts`, `snooker`, `badminton`, `futsal`, `waterpolo`, `aussie-rules`, `beach-volley`, `cycling`, `floorball`, `bandy`, `minifootball`, `padel` (`soccer`, `hockey`, `nfl` and `ufc` are accepted as aliases). Used by the Scheduled and Live modes; Trending covers every sport. Leave empty to scrape only match URLs.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "scheduled",
              "live",
              "trending"
            ],
            "type": "string",
            "description": "Which matches to list: every match of the sport on a day (Scheduled), the matches in progress right now (Live), or the matches fans in a country are following across all sports (Trending).",
            "default": "scheduled"
          },
          "date": {
            "title": "Date (scheduled only)",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Day to list as `YYYY-MM-DD` — past days give results, future days give fixtures. Optional: leave it empty and the API lists today (in the Timezone Offset). Only applies to the Scheduled mode."
          },
          "tournamentId": {
            "title": "Tournament id (scheduled only)",
            "type": "string",
            "description": "Only that competition's matches on the day, e.g. `17` for the Premier League or a pasted sofascore.com tournament URL. Only applies to the Scheduled mode."
          },
          "categoryId": {
            "title": "Category id (scheduled only)",
            "type": "string",
            "description": "Only that country's or region's matches on the day — a Sofascore category id such as `1` for England. Only applies to the Scheduled mode."
          },
          "timezoneOffset": {
            "title": "Timezone Offset (scheduled only)",
            "type": "string",
            "description": "Hours from UTC that set the day boundary, from `-12` to `14` (half hours like `5.5` are fine). Leave empty for UTC. Only applies to the Scheduled mode."
          },
          "country": {
            "title": "Country (trending only)",
            "type": "string",
            "description": "2-letter ISO country code whose fans' trending matches to list, e.g. `US`, `GB`, `IN`, `BR`. Only applies to the Trending mode.",
            "default": "US"
          },
          "matchUrls": {
            "title": "Match URLs",
            "type": "array",
            "description": "Sofascore match URLs like `https://www.sofascore.com/football/match/aston-villa-manchester-city/rP#id:14023961` or bare match ids like `14023961`. Always scraped with full details (billed at the detailed-match rate).",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Max Matches per Search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of matches to scrape per sport (or per trending list). Use this to control your cost (1,000 matches ≈ $1). Ignored for match URLs.",
            "default": 100
          },
          "scrapeDetails": {
            "title": "Scrape Full Match Details",
            "type": "boolean",
            "description": "When enabled, every match found is also scraped in full — managers, venue with coordinates, referee with career totals, attendance and period format, plus team statistics per period (possession, xG, shots, passes, duels, tackles, goalkeeping), confirmed lineups and benches with formation, missing players and every player's per-match statistics, and the incident timeline (goals with scorer, assist and xG, cards, substitutions, VAR decisions, injury time). Still one dataset row per match, billed once at the detailed-match rate instead of the standard rate (1,000 detailed matches ≈ $3 vs $1 standard). Runs take longer because each match is fetched individually.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}