> For the complete documentation index, see [llms.txt](https://docs.thesports.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thesports.com/help-center/football/description-of-real-time-data.md).

# Description of real-time data

We provide three real-time API endpoints:

1. [**Real-time data**](/thesports-docs/basic-data/real-time-data.md)
2. [**Match player statistics**](/thesports-docs/basic-data/match-player-statistics.md)
3. [Match team statistics](/thesports-docs/basic-data/match-team-statistics.md)

The **Real-time data** API endpoint covers most matches.

The **Match player statistics** and **Match team statistics** API endpoints cover only popular competitions. Some less popular or lower-level competitions may not provide this data, or the returned data may be incomplete. Refer to the actual API response to determine data availability.

### How should overlapping statistical items be displayed?

Some statistical items may be returned by both the **Real-time data** and **Match team statistics** API endpoints. We recommend displaying the data from these API endpoints separately on different pages.

For example, you can display 'Real-time data' on the left and 'Match team statistics' on the right.

<figure><img src="/files/pE4Pbwn2fMpemPJnbMgT" alt=""><figcaption></figcaption></figure>

### How to supplement missing real-time data

Use the following API endpoints to retrieve data for a completed match:

1. [**Statistical data (historical matches)**](/thesports-docs/basic-data/statistical-data-historical-matches.md) corresponds to **Real-time data**.
2. [**Player statistics (historical matches)** ](/thesports-docs/basic-data/player-statistics-historical-matches.md)corresponds to **Match player statistics**.
3. [**Team statistics (historical matches)**](/thesports-docs/basic-data/team-statistics-historical-matches.md) corresponds to **Match team statistics**.

These three API endpoints use a completed `match id` as the query parameter and return data for the specified match. Use them primarily to supplement data missing from the real-time API endpoints.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thesports.com/help-center/football/description-of-real-time-data.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.