Skip to content
Video/
Get Timings

Bepro Data API (2.0.0)

Welcome to the Bepro Data API documentation. This API provides comprehensive access to Bepro's whole database based on your own service permission scope, including events, stats, positional data, or meta data etc.

Overview

This section covers the essential information you need to get started with the Bepro Data API.

Authentication

All API requests require authentication using a Bearer token.

Include the token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

To obtain an API token, please contact the Bepro team.

Rate Limits

  • Rate Limit: 1000 requests per minute per API token
  • Burst Limit: 100 requests per second

When you exceed the rate limit, you'll receive a 429 Too Many Requests response.

Event Definition

For detailed information about event types and their properties, please refer to our Event Definition Documentation:

Coordinates

All coordinate values in the API use a normalized coordinate system:

  • X-axis: 0.0 (left) to 1.0 (right)
  • Y-axis: 0.0 (bottom) to 1.0 (top)
  • Origin: Bottom-left corner (0, 0)

Version History

v2.0.0 (Current)

  • Initial release of the new Data API v2
Servers
https://ds.bepro.ai/data-api/

Meta

Operations

Data

Operations

Video

Operations

Get Timings

Request

Query
match_idstring(Match Id)required
langstring(Lang)
Default "en"

Responses

Successful Response

Bodyapplication/json
countinteger(Count)required
dataArray of objects(Data)required
data[].​match_idinteger(Match Id)required
data[].​period_orderinteger(Period Order)required
data[].​period_namestring(Period Name)required
data[].​period_official_durationPeriod Official Duration (integer) or Period Official Duration (null)(Period Official Duration)
Any of:
integer(Period Official Duration)
data[].​video_idinteger(Video Id)required
data[].​video_urlVideo Url (string) or Video Url (null)(Video Url)
Any of:
string(Video Url)
data[].​match_start_timeMatch Start Time (integer) or Match Start Time (null)(Match Start Time)
Any of:
integer(Match Start Time)
data[].​match_end_timeMatch End Time (integer) or Match End Time (null)(Match End Time)
Any of:
integer(Match End Time)
data[].​video_start_timeVideo Start Time (integer) or Video Start Time (null)(Video Start Time)
Any of:
integer(Video Start Time)
data[].​video_end_timeVideo End Time (integer) or Video End Time (null)(Video End Time)
Any of:
integer(Video End Time)
Response
application/json
{
  "count": 0,
  "data": [
    { … }
  ]
}

External

Operations