Docs menu

SofaScore API endpoint

SofaScore trending events API

Returns the events trending in one country across every sport (live, recent and upcoming), each as the usual event summary plus its `sport` key. `country` is a two-letter ISO 3166-1 alpha-2 code such as `GB` or `US` (any case); SofaScore serves a trending list per country, and a code it does not serve returns 404. The list is about twenty events and changes through the day.

GETapiKey2 credits/requestSofaScoresofascore.trendingEventsResponseDoc/sofascore/trending-events

Endpoint facts

Method: GET
API path: /sofascore/trending-events
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.trendingEventsResponseDoc

SofaScore API Try SofaScore trending events API in Playground SofaScore API documentation

How this endpoint behaves

Query parameters:

country: required. Two-letter ISO 3166-1 alpha-2 country code, e.g. GB or US (any case).

Notable response behavior:

Each event is the usual event summary (teams, score, status, tournament) plus its sport key. The list holds about twenty events and changes through the day.
A country code of the wrong format returns 400. SofaScore serves a trending list per country; a well-formed code it does not serve returns 404 (ZZ was 404 when checked).

Live monitoring

Monitored request: GET /sofascore/trending-events?country=GB
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.06 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/trending-events?country=GB
Items in events: 61
Fields filled in every checked item: 9
Fields empty in some or all items: 3

Field	Filled in, of 61 checked	Values in the sample
id	61
slug	61
start_timestamp	61	2026-10-11 to 2026-10-16
start_time	61	2026-10-11 to 2026-10-16
status	61
winner_code	22
tournament	61
home_team	61
away_team	61
home_score	22
away_score	22
sport	61	“basketball” and 8 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
country	string	Yes		Two-letter ISO 3166-1 alpha-2 country code	GB
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/trending-events?country=GB" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "GB",
    "source_url": "https://api.sofascore.com/api/v1/trending/events/GB/all",
    "fetched_at": "2026-07-08T00:00:00Z",
    "count": 2,
    "events": [
      {
        "id": 17193371,
        "slug": "atlanta-braves-los-angeles-dodgers",
        "start_timestamp": 1791158400,
        "start_time": "2026-10-05T00:00:00Z",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winner_code": 2,
        "tournament": {
          "id": 108845,
          "name": "MLB Postseason",
          "slug": "mlb-playoffs",
          "category": "USA",
          "unique_tournament_id": 11205,
          "unique_tournament_name": "MLB"
        },
        "home_team": {
          "id": 3638,
          "name": "Los Angeles Dodgers",
          "short_name": "Dodgers",
          "slug": "los-angeles-dodgers",
          "country": "USA"
        },
        "away_team": {
          "id": 3656,
          "name": "Atlanta Braves",
          "short_name": "Braves",
          "slug": "atlanta-braves",
          "country": "USA"
        },
        "home_score": {
          "current": 2
        },
        "away_score": {
          "current": 3,
          "period1": 1
        },
        "sport": "baseball"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.trendingEventsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.TrendingEventsResponse	No
data.count	integer	No
data.country	string	No	GB
data.events	array	No
data.events[].away_score	object	No		Away side's score, when available.
data.events[].away_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].away_score.period1	integer	No		Score in the first period.
data.events[].away_score.period2	integer	No		Score in the second period.
data.events[].away_team	object	No		Away side.
data.events[].away_team.country	string	No	Spain	Country the team belongs to.
data.events[].away_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].away_team.name	string	No	FC Barcelona	Full team name.
data.events[].away_team.national	boolean	No		True for a national team.
data.events[].away_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].away_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].home_score	object	No		Home side's score, when available.
data.events[].home_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].home_score.period1	integer	No		Score in the first period.
data.events[].home_score.period2	integer	No		Score in the second period.
data.events[].home_team	object	No		Home side.
data.events[].home_team.country	string	No	Spain	Country the team belongs to.
data.events[].home_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].home_team.name	string	No	FC Barcelona	Full team name.
data.events[].home_team.national	boolean	No		True for a national team.
data.events[].home_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].home_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].id	integer	No	14025013	SofaScore event id. Use it with the event endpoints.
data.events[].slug	string	No		URL slug of the match on SofaScore.
data.events[].sport	string	No	football
data.events[].start_time	string	No	2025-08-15T19:00:00Z	Start time in UTC (RFC 3339).
data.events[].start_timestamp	integer	No		Start time as a Unix timestamp in seconds.
data.events[].status	object	No		Current status of the match.
data.events[].status.code	integer	No		SofaScore's numeric status code, for example 0 for not started and 100 for ended.
data.events[].status.description	string	No	Ended	Status as displayed, for example "Ended".
data.events[].status.type	string	No	finished	Status group, for example `notstarted`, `inprogress` or `finished`.
data.events[].tournament	object	No		Tournament and parent competition the match belongs to.
data.events[].tournament.category	string	No	England	Category the tournament sits under, usually a country or region.
data.events[].tournament.id	integer	No		SofaScore id of the tournament the match is filed under. The seasons, standings and round endpoints take `unique_tournament_id` instead.
data.events[].tournament.name	string	No	Premier League	Tournament name.
data.events[].tournament.slug	string	No	premier-league	URL slug of the tournament on SofaScore.
data.events[].tournament.unique_tournament_id	integer	No	17	Id of the parent competition. This is the tournament id the tournament-seasons, standings and round-events endpoints take.
data.events[].tournament.unique_tournament_name	string	No	Premier League	Name of the parent competition.
data.events[].winner_code	integer	No		Result code: 1 when the home side won, 2 when the away side won, 3 for a draw. Omitted until the match is decided.
data.fetched_at	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sofascore/trending-events?country=GB" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More SofaScore endpoint docs SofaScore API SofaScore categories for a sport API documentation SofaScore competitions in a category API documentation SofaScore league draft picks API documentation SofaScore league draft API documentation SofaScore esports game detail API documentation SofaScore event at-bat pitches API documentation

Open in Playground Back to group

Docs menu

SofaScore API endpoint

SofaScore trending events API

GETapiKey2 credits/requestSofaScoresofascore.trendingEventsResponseDoc/sofascore/trending-events

Endpoint facts

Method: GET
API path: /sofascore/trending-events
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.trendingEventsResponseDoc

SofaScore API Try SofaScore trending events API in Playground SofaScore API documentation

How this endpoint behaves

Query parameters:

country: required. Two-letter ISO 3166-1 alpha-2 country code, e.g. GB or US (any case).

Notable response behavior:

Each event is the usual event summary (teams, score, status, tournament) plus its sport key. The list holds about twenty events and changes through the day.
A country code of the wrong format returns 400. SofaScore serves a trending list per country; a well-formed code it does not serve returns 404 (ZZ was 404 when checked).

Live monitoring

Monitored request: GET /sofascore/trending-events?country=GB
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.06 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/trending-events?country=GB
Items in events: 61
Fields filled in every checked item: 9
Fields empty in some or all items: 3

Field	Filled in, of 61 checked	Values in the sample
id	61
slug	61
start_timestamp	61	2026-10-11 to 2026-10-16
start_time	61	2026-10-11 to 2026-10-16
status	61
winner_code	22
tournament	61
home_team	61
away_team	61
home_score	22
away_score	22
sport	61	“basketball” and 8 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
country	string	Yes		Two-letter ISO 3166-1 alpha-2 country code	GB
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/trending-events?country=GB" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "GB",
    "source_url": "https://api.sofascore.com/api/v1/trending/events/GB/all",
    "fetched_at": "2026-07-08T00:00:00Z",
    "count": 2,
    "events": [
      {
        "id": 17193371,
        "slug": "atlanta-braves-los-angeles-dodgers",
        "start_timestamp": 1791158400,
        "start_time": "2026-10-05T00:00:00Z",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winner_code": 2,
        "tournament": {
          "id": 108845,
          "name": "MLB Postseason",
          "slug": "mlb-playoffs",
          "category": "USA",
          "unique_tournament_id": 11205,
          "unique_tournament_name": "MLB"
        },
        "home_team": {
          "id": 3638,
          "name": "Los Angeles Dodgers",
          "short_name": "Dodgers",
          "slug": "los-angeles-dodgers",
          "country": "USA"
        },
        "away_team": {
          "id": 3656,
          "name": "Atlanta Braves",
          "short_name": "Braves",
          "slug": "atlanta-braves",
          "country": "USA"
        },
        "home_score": {
          "current": 2
        },
        "away_score": {
          "current": 3,
          "period1": 1
        },
        "sport": "baseball"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.trendingEventsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.TrendingEventsResponse	No
data.count	integer	No
data.country	string	No	GB
data.events	array	No
data.events[].away_score	object	No		Away side's score, when available.
data.events[].away_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].away_score.period1	integer	No		Score in the first period.
data.events[].away_score.period2	integer	No		Score in the second period.
data.events[].away_team	object	No		Away side.
data.events[].away_team.country	string	No	Spain	Country the team belongs to.
data.events[].away_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].away_team.name	string	No	FC Barcelona	Full team name.
data.events[].away_team.national	boolean	No		True for a national team.
data.events[].away_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].away_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].home_score	object	No		Home side's score, when available.
data.events[].home_score.current	integer	No		Current score, which is the final score once the match is over.
data.events[].home_score.period1	integer	No		Score in the first period.
data.events[].home_score.period2	integer	No		Score in the second period.
data.events[].home_team	object	No		Home side.
data.events[].home_team.country	string	No	Spain	Country the team belongs to.
data.events[].home_team.id	integer	No	2817	SofaScore team id. Use it with the team endpoints.
data.events[].home_team.name	string	No	FC Barcelona	Full team name.
data.events[].home_team.national	boolean	No		True for a national team.
data.events[].home_team.short_name	string	No	Barcelona	Shortened team name.
data.events[].home_team.slug	string	No	barcelona	URL slug of the team on SofaScore.
data.events[].id	integer	No	14025013	SofaScore event id. Use it with the event endpoints.
data.events[].slug	string	No		URL slug of the match on SofaScore.
data.events[].sport	string	No	football
data.events[].start_time	string	No	2025-08-15T19:00:00Z	Start time in UTC (RFC 3339).
data.events[].start_timestamp	integer	No		Start time as a Unix timestamp in seconds.
data.events[].status	object	No		Current status of the match.
data.events[].status.code	integer	No		SofaScore's numeric status code, for example 0 for not started and 100 for ended.
data.events[].status.description	string	No	Ended	Status as displayed, for example "Ended".
data.events[].status.type	string	No	finished	Status group, for example `notstarted`, `inprogress` or `finished`.
data.events[].tournament	object	No		Tournament and parent competition the match belongs to.
data.events[].tournament.category	string	No	England	Category the tournament sits under, usually a country or region.
data.events[].tournament.id	integer	No		SofaScore id of the tournament the match is filed under. The seasons, standings and round endpoints take `unique_tournament_id` instead.
data.events[].tournament.name	string	No	Premier League	Tournament name.
data.events[].tournament.slug	string	No	premier-league	URL slug of the tournament on SofaScore.
data.events[].tournament.unique_tournament_id	integer	No	17	Id of the parent competition. This is the tournament id the tournament-seasons, standings and round-events endpoints take.
data.events[].tournament.unique_tournament_name	string	No	Premier League	Name of the parent competition.
data.events[].winner_code	integer	No		Result code: 1 when the home side won, 2 when the away side won, 3 for a draw. Omitted until the match is decided.
data.fetched_at	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sofascore/trending-events?country=GB" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

SofaScore trending events API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

SofaScore trending events API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related