Sofascore Scraper

Search Sofascore by keyword and get back teams, players, tournaments and matches with live and historical scores. Covers football, basketball, tennis and more, returned as clean JSON ready for analysis.

What you can do with it

• Build betting and prediction models: pull recent and upcoming matches with scores and status to feed your data pipeline.
• Power stats dashboards: track a team's form across its last and next fixtures with one keyword.
• Scout players and tournaments: resolve a name to its Sofascore entity, id, slug and URL.
• Monitor fixtures across sports: football, basketball, tennis and others from a single search.
• Enrich sports content: generate match previews and recaps from structured score and tournament data.

Input

Field	Type	Description
searchTerm	string	Team, player, tournament or league to search (e.g. "Real Madrid", "Djokovic", "Premier League").
includeMatches	boolean	When the top match is a team, also fetch its recent and upcoming matches with scores. Default true.
maxItems	integer	Maximum number of items to return. Default 50.

Example input

{
  "searchTerm": "Real Madrid",
  "includeMatches": true,
  "maxItems": 50
}

Output

One dataset item per result. Search-entity items (teams, players, tournaments) look like this:

{
  "type": "team",
  "name": "Real Madrid",
  "sport": "Football",
  "country": "Spain",
  "team": null,
  "homeTeam": null,
  "awayTeam": null,
  "score": null,
  "startTime": null,
  "userCount": 4821336,
  "sofascoreId": 2829,
  "slug": "real-madrid",
  "url": "https://www.sofascore.com/team/real-madrid/2829",
  "searchTerm": "Real Madrid",
  "scrapedAt": "2026-06-26T12:00:00.000Z"
}

Match items (returned when includeMatches is on) look like this:

{
  "type": "match",
  "name": "Real Madrid vs Barcelona",
  "sport": "Football",
  "country": "Spain",
  "tournament": "LaLiga",
  "homeTeam": "Real Madrid",
  "awayTeam": "Barcelona",
  "score": "2-1",
  "statusType": "finished",
  "statusDescription": "Ended",
  "startTime": "2026-05-11T19:00:00.000Z",
  "sofascoreId": 11352507,
  "url": "https://www.sofascore.com/event/11352507",
  "searchTerm": "Real Madrid",
  "scrapedAt": "2026-06-26T12:00:00.000Z"
}

Pricing

$0.003 per result scraped (pay per event). You are not charged for failed pages or duplicates.

Notes and limits

• A run starts from the search keyword. The first matching team is the one whose recent and upcoming matches are fetched, so a precise searchTerm gives the most relevant fixtures.
• Match items only appear when includeMatches is true and the top result is a team; player and tournament searches return entity items only.
• The score field is null for fixtures that have not been played yet, and for all search-entity items.
• Sofascore sits behind aggressive bot protection. If a run returns no results, the search was likely blocked; retry or try a slightly different keyword.