# Sofascore Events API

> Live scores, fixtures and results for football, tennis, cricket, basketball and more, with match statistics, lineups, shotmaps, heatmaps, odds, scorecards, standings, season…

- [Count live and total events per sport (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-event-counts.md): Returns, for every sport, how many events are live now and how many are on today, with the day set by timezone_offset. Nothing found returns data: null.
- [Count live events per category (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-categories.md): Returns a map of category id to the number of sport events in play in that category. Nothing live returns an empty map.
- [Count live events per tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-tournaments.md): Returns a map of sub-tournament id to the number of sport events in play in it. Nothing live returns an empty map.
- [Get a compact list of upcoming events (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-upcoming-events.md): Returns id, team ids, tournament ids and start time for every event of sport on date. Only today and later dates have data; past dates return data: null.
- [Get a day's events by tournament (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-events-by-date.md): Returns all events on date for one tournament or one category (country or circuit), with scores and status. An unknown id returns data: null.
- [Get events added in the last 6 hours (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-new-events.md): Returns events in snooker, darts, tennis, table tennis and esports created in the last 6 hours that start in the next 6 hours, as event, team and tournament ids. Nothing found returns data: null.
- [Get every event of a sport on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-events-for-a-day.md): Returns one page of every event of sport on date (UTC), in start order. Pages run from 1; Get Sports Day Index gives the page count. A page past the end returns an empty list.
- [Get live events for a sport (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-events.md): Returns every event in play for sport with live scores, status, teams and tournament. Nothing in play returns an empty list.
- [Get popular events in a country (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-popular-events-by-country.md): Returns up to 8 of the most popular events of sport on date for fans in country, using that country's local day. Nothing found returns data: null.
- [Get the categories playing on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-day-categories.md): Returns every category with sport events on date, with event counts, live counts and flags for available player statistics. The day follows timezone_offset. Nothing found returns data: null.
- [Get the most popular events (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-popular-events.md): Returns the most followed events starting between 12 hours ago and 3 days ahead, for sport or across all sports when sport is omitted. Nothing found returns data: null.
- [Get the most voted upcoming events (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-most-voted-events.md): Returns ids of up to 500 not-started events with the most fan votes this week, with each event's sport. Use the ids with Get Sports Event. Nothing found returns data: null.
- [Get the next event with AI insights (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-next-ai-insight-event.md): Returns the next football event with AI match insights ready. Read them with Get Sports Event AI Insights after the match ends. Nothing found returns data: null.
- [Get the page index for a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-day-index.md): Returns how many pages Get Sports Events for a Day has for sport on date, with each page's first and last start time and the filters it covers. Nothing found returns data: null.
- [Get the top event with a live stream (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-live-stream-event.md): Returns the single most popular event with a live stream for sport, preferring events in play. Nothing found returns data: null.
- [Get tournaments playing on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-schedule.md): Returns the tournaments with events on date for sport, 100 per page, with each one's event count. Use a tournament id with Get Sports Events by Date.
- [Get tournaments with events on a day (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-active-tournaments.md): Returns sub-tournament id, name and slug for every sport tournament with events on date, padded 4 hours either side of the UTC day. Nothing found returns data: null.
- [Split a day's tournaments by status (v1)](https://docs.toolzerhub.com/reference/sofascore/events/get-sports-finished-and-upcoming.md): Returns the sub-tournaments with sport events on date, split into finished and upcoming, each with event counts per UTC offset. Nothing found returns data: null.
