API Reference
Use Crawlora's SofaScore API endpoints to extract supported public SofaScore data as structured JSON. This documentation covers 15 active endpoints including SofaScore event head-to-head, SofaScore event incidents, SofaScore event lineups, SofaScore event odds, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as id, sport, season, round, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/sofascore/search?q=coffee" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/sofascore/event-h2hapiKey2 credits/requestReturns the historical head-to-head win/draw record between a match's two teams (and managers, when available) from SofaScore's credential-free public JSON.
Required params: id:query
/sofascore/event-incidentsapiKey1 credit/requestReturns one match's goal, card, substitution, and period timeline from SofaScore's credential-free public JSON. An empty `incidents` list is a valid response before kickoff.
Required params: id:query
/sofascore/event-lineupsapiKey2 credits/requestReturns one match's starting XI and substitutes per side, with formation, from SofaScore's credential-free public JSON. Returns 404 when SofaScore has no lineups for the match.
Required params: id:query
/sofascore/event-oddsapiKey2 credits/requestReturns one match's betting markets and choices from SofaScore's credential-free public JSON. Returns 404 when SofaScore has no odds for the match.
Required params: id:query
/sofascore/event-statisticsapiKey2 credits/requestReturns one match's statistics (possession, shots, passes, and more, grouped and split by period) from SofaScore's credential-free public JSON. Returns 404 when SofaScore has no tracked statistics for the match.
Required params: id:query
/sofascore/eventapiKey1 credit/requestReturns one match's detail (teams, score, status, venue, referee) from SofaScore's credential-free public JSON.
Required params: id:query
/sofascore/live-eventsapiKey1 credit/requestReturns currently live events for a sport from SofaScore's credential-free public JSON. The `sport` enum accepts `football`, `basketball`, and `tennis`. An empty `events` list is a valid response when nothing is live right now.
Required params: sport:query
/sofascore/playerapiKey1 credit/requestReturns one player's bio (position, height, market value, current team) from SofaScore's credential-free public JSON.
Required params: id:query
/sofascore/round-eventsapiKey1 credit/requestReturns fixtures for one round of a competition season from SofaScore's credential-free public JSON. Get `id` from search and `season` from tournament-seasons.
Required params: id:query, season:query, round:query
/sofascore/searchapiKey1 credit/requestSearches SofaScore's credential-free public JSON for teams, players, and competitions matching a free-text query. An empty `results` list is a valid response when nothing matches.
Required params: q:query
/sofascore/standingsapiKey2 credits/requestReturns a league table for a competition season from SofaScore's credential-free public JSON. The `type` enum accepts `total`, `home`, and `away`. Get `id` from search and `season` from tournament-seasons.
Required params: id:query, season:query, type:query
/sofascore/team-eventsapiKey1 credit/requestReturns a page of a team's upcoming or recent fixtures from SofaScore's credential-free public JSON. The `direction` enum accepts `next` and `last`. An empty `events` list is a valid response when there is no fixture on that page.
Required params: id:query, direction:query
/sofascore/team-playersapiKey1 credit/requestReturns a team's full squad from SofaScore's credential-free public JSON.
Required params: id:query
/sofascore/teamapiKey1 credit/requestReturns one team's detail (identity, manager, venue, primary competition) from SofaScore's credential-free public JSON.
Required params: id:query
/sofascore/tournament-seasonsapiKey1 credit/requestReturns the season list for a competition from SofaScore's credential-free public JSON. Use a returned season id with the standings and round-events endpoints.
Required params: id:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| SofaScore event head-to-head | /sofascore/event-h2h | GET | 2 credits/request | id:query | View docs | Try endpoint |
| SofaScore event incidents | /sofascore/event-incidents | GET | 1 credit/request | id:query | View docs | Try endpoint |
| SofaScore event lineups | /sofascore/event-lineups | GET | 2 credits/request | id:query | View docs | Try endpoint |
| SofaScore event odds | /sofascore/event-odds | GET | 2 credits/request | id:query | View docs | Try endpoint |
| SofaScore event statistics | /sofascore/event-statistics | GET | 2 credits/request | id:query | View docs | Try endpoint |
| SofaScore event detail | /sofascore/event | GET | 1 credit/request | id:query | View docs | Try endpoint |
| SofaScore live events | /sofascore/live-events | GET | 1 credit/request | sport:query | View docs | Try endpoint |
| SofaScore player detail | /sofascore/player | GET | 1 credit/request | id:query | View docs | Try endpoint |
| SofaScore round fixtures | /sofascore/round-events | GET | 1 credit/request | id:query, season:query, round:query | View docs | Try endpoint |
| SofaScore universal search | /sofascore/search | GET | 1 credit/request | q:query | View docs | Try endpoint |
| SofaScore standings | /sofascore/standings | GET | 2 credits/request | id:query, season:query, type:query | View docs | Try endpoint |
| SofaScore team fixtures | /sofascore/team-events | GET | 1 credit/request | id:query, direction:query | View docs | Try endpoint |
| SofaScore team players | /sofascore/team-players | GET | 1 credit/request | id:query | View docs | Try endpoint |
| SofaScore team detail | /sofascore/team | GET | 1 credit/request | id:query | View docs | Try endpoint |
| SofaScore competition seasons | /sofascore/tournament-seasons | GET | 1 credit/request | id:query | View docs | Try endpoint |