Get External Leagues

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/

Data

Operations

Video

Operations

External

Operations

Get External Clubs

Request

Query

offsetinteger(Offset)

Default 0

limitinteger(Limit)

Default 100

bepro_club_idsBepro Club Ids (string) or Bepro Club Ids (null)(Bepro Club Ids)

Any of:

string(Bepro Club Ids)

external_club_idsExternal Club Ids (string) or External Club Ids (null)(External Club Ids)

Any of:

string(External Club Ids)

Responses

Successful Response

Bodyapplication/json

countinteger(Count)required

nextNext (string) or Next (null)(Next)

Any of:

string(Next)

prevPrev (string) or Prev (null)(Prev)

Any of:

string(Prev)

dataArray of objects(Data)required

data[].external_club_idExternal Club Id (integer) or External Club Id (null)(External Club Id)

Any of:

integer(External Club Id)

data[].bepro_club_idBepro Club Id (integer) or Bepro Club Id (null)(Bepro Club Id)

Any of:

integer(Bepro Club Id)

data[].bepro_club_nameBepro Club Name (string) or Bepro Club Name (null)(Bepro Club Name)

Any of:

string(Bepro Club Name)

data[].bepro_club_name_enBepro Club Name En (string) or Bepro Club Name En (null)(Bepro Club Name En)

Any of:

string(Bepro Club Name En)

Response

application/json

{
  "count": 0,
  "next": "string",
  "prev": "string",
  "data": [
    { … }
  ]
}

Get External Leagues

Request

Query

offsetinteger(Offset)

Default 0

limitinteger(Limit)

Default 100

bepro_league_idsBepro League Ids (string) or Bepro League Ids (null)(Bepro League Ids)

Any of:

string(Bepro League Ids)

external_league_idsExternal League Ids (string) or External League Ids (null)(External League Ids)

Any of:

string(External League Ids)

Responses

Successful Response

Bodyapplication/json

countinteger(Count)required

nextNext (string) or Next (null)(Next)

Any of:

string(Next)

prevPrev (string) or Prev (null)(Prev)

Any of:

string(Prev)

dataArray of objects(Data)required

data[].external_league_idExternal League Id (integer) or External League Id (null)(External League Id)

Any of:

integer(External League Id)

data[].bepro_league_idBepro League Id (integer) or Bepro League Id (null)(Bepro League Id)

Any of:

integer(Bepro League Id)

data[].bepro_league_nameBepro League Name (string) or Bepro League Name (null)(Bepro League Name)

Any of:

string(Bepro League Name)

data[].bepro_league_name_enBepro League Name En (string) or Bepro League Name En (null)(Bepro League Name En)

Any of:

string(Bepro League Name En)

Response

application/json

{
  "count": 0,
  "next": "string",
  "prev": "string",
  "data": [
    { … }
  ]
}

Get External Matches

Request

Query

offsetinteger(Offset)

Default 0

limitinteger(Limit)

Default 100

bepro_match_idsBepro Match Ids (string) or Bepro Match Ids (null)(Bepro Match Ids)

Any of:

string(Bepro Match Ids)

external_match_idsExternal Match Ids (string) or External Match Ids (null)(External Match Ids)

Any of:

string(External Match Ids)

Responses

Successful Response

Bodyapplication/json

countinteger(Count)required

nextNext (string) or Next (null)(Next)

Any of:

string(Next)

prevPrev (string) or Prev (null)(Prev)

Any of:

string(Prev)

dataArray of objects(Data)required

data[].external_match_idinteger(External Match Id)required

data[].bepro_match_idBepro Match Id (integer) or Bepro Match Id (null)(Bepro Match Id)required

Any of:

integer(Bepro Match Id)

data[].bepro_home_team_idBepro Home Team Id (integer) or Bepro Home Team Id (null)(Bepro Home Team Id)

Any of:

integer(Bepro Home Team Id)

data[].bepro_home_team_name_enBepro Home Team Name En (string) or Bepro Home Team Name En (null)(Bepro Home Team Name En)

Any of:

string(Bepro Home Team Name En)

data[].bepro_away_team_idBepro Away Team Id (integer) or Bepro Away Team Id (null)(Bepro Away Team Id)

Any of:

integer(Bepro Away Team Id)

data[].bepro_away_team_name_enBepro Away Team Name En (string) or Bepro Away Team Name En (null)(Bepro Away Team Name En)

Any of:

string(Bepro Away Team Name En)

data[].match_start_timeMatch Start Time (string) or Match Start Time (null)(Match Start Time)

Any of:

string(Match Start Time)

Response

application/json

{
  "count": 0,
  "next": "string",
  "prev": "string",
  "data": [
    { … }
  ]
}

Get External Players

Request

Query

offsetinteger(Offset)

Default 0

limitinteger(Limit)

Default 100

bepro_player_idsBepro Player Ids (string) or Bepro Player Ids (null)(Bepro Player Ids)

Any of:

string(Bepro Player Ids)

external_player_idsExternal Player Ids (string) or External Player Ids (null)(External Player Ids)

Any of:

string(External Player Ids)

Responses

Successful Response

Bodyapplication/json

countinteger(Count)required

nextNext (string) or Next (null)(Next)

Any of:

string(Next)

prevPrev (string) or Prev (null)(Prev)

Any of:

string(Prev)

dataArray of objects(Data)required

data[].external_player_idExternal Player Id (integer) or External Player Id (null)(External Player Id)

Any of:

integer(External Player Id)

data[].bepro_player_idBepro Player Id (integer) or Bepro Player Id (null)(Bepro Player Id)

Any of:

integer(Bepro Player Id)

data[].bepro_player_nameBepro Player Name (string) or Bepro Player Name (null)(Bepro Player Name)

Any of:

string(Bepro Player Name)

data[].bepro_player_name_enBepro Player Name En (string) or Bepro Player Name En (null)(Bepro Player Name En)

Any of:

string(Bepro Player Name En)

data[].bepro_player_last_nameBepro Player Last Name (string) or Bepro Player Last Name (null)(Bepro Player Last Name)

Any of:

string(Bepro Player Last Name)

data[].bepro_player_last_name_enBepro Player Last Name En (string) or Bepro Player Last Name En (null)(Bepro Player Last Name En)

Any of:

string(Bepro Player Last Name En)

data[].bepro_player_full_nameBepro Player Full Name (string) or Bepro Player Full Name (null)(Bepro Player Full Name)

Any of:

string(Bepro Player Full Name)

data[].bepro_player_full_name_enBepro Player Full Name En (string) or Bepro Player Full Name En (null)(Bepro Player Full Name En)

Any of:

string(Bepro Player Full Name En)

data[].bepro_team_idBepro Team Id (integer) or Bepro Team Id (null)(Bepro Team Id)

Any of:

integer(Bepro Team Id)

data[].bepro_team_nameBepro Team Name (string) or Bepro Team Name (null)(Bepro Team Name)

Any of:

string(Bepro Team Name)

data[].bepro_team_name_enBepro Team Name En (string) or Bepro Team Name En (null)(Bepro Team Name En)

Any of:

string(Bepro Team Name En)

Response

application/json

{
  "count": 0,
  "next": "string",
  "prev": "string",
  "data": [
    { … }
  ]
}

Get External Seasons

Request

Query

offsetinteger(Offset)

Default 0

limitinteger(Limit)

Default 100

bepro_season_idsBepro Season Ids (string) or Bepro Season Ids (null)(Bepro Season Ids)

Any of:

string(Bepro Season Ids)

bepro_league_idsBepro League Ids (string) or Bepro League Ids (null)(Bepro League Ids)

Any of:

string(Bepro League Ids)

external_season_idsExternal Season Ids (string) or External Season Ids (null)(External Season Ids)

Any of:

string(External Season Ids)

external_league_idsExternal League Ids (string) or External League Ids (null)(External League Ids)

Any of:

string(External League Ids)

Responses

Successful Response

Bodyapplication/json

countinteger(Count)required

nextNext (string) or Next (null)(Next)

Any of:

string(Next)

prevPrev (string) or Prev (null)(Prev)

Any of:

string(Prev)

dataArray of objects(Data)required

data[].external_season_idExternal Season Id (integer) or External Season Id (null)(External Season Id)

Any of:

integer(External Season Id)

data[].bepro_season_idBepro Season Id (integer) or Bepro Season Id (null)(Bepro Season Id)

Any of:

integer(Bepro Season Id)

data[].bepro_season_nameBepro Season Name (string) or Bepro Season Name (null)(Bepro Season Name)

Any of:

string(Bepro Season Name)

data[].bepro_league_idBepro League Id (integer) or Bepro League Id (null)(Bepro League Id)

Any of:

integer(Bepro League Id)

data[].bepro_league_nameBepro League Name (string) or Bepro League Name (null)(Bepro League Name)

Any of:

string(Bepro League Name)

Response

application/json

{
  "count": 0,
  "next": "string",
  "prev": "string",
  "data": [
    { … }
  ]
}

Get External Teams

Request

Query

offsetinteger(Offset)

Default 0

limitinteger(Limit)

Default 100

bepro_team_idsBepro Team Ids (string) or Bepro Team Ids (null)(Bepro Team Ids)

Any of:

string(Bepro Team Ids)

bepro_club_idsBepro Club Ids (string) or Bepro Club Ids (null)(Bepro Club Ids)

Any of:

string(Bepro Club Ids)

external_team_idsExternal Team Ids (string) or External Team Ids (null)(External Team Ids)

Any of:

string(External Team Ids)

external_club_idsExternal Club Ids (string) or External Club Ids (null)(External Club Ids)

Any of:

string(External Club Ids)

Responses

Successful Response

Bodyapplication/json

countinteger(Count)required

nextNext (string) or Next (null)(Next)

Any of:

string(Next)

prevPrev (string) or Prev (null)(Prev)

Any of:

string(Prev)

dataArray of objects(Data)required

data[].external_team_idExternal Team Id (integer) or External Team Id (null)(External Team Id)

Any of:

integer(External Team Id)

data[].bepro_club_idBepro Club Id (integer) or Bepro Club Id (null)(Bepro Club Id)

Any of:

integer(Bepro Club Id)

data[].bepro_club_nameBepro Club Name (string) or Bepro Club Name (null)(Bepro Club Name)

Any of:

string(Bepro Club Name)

data[].bepro_club_name_enBepro Club Name En (string) or Bepro Club Name En (null)(Bepro Club Name En)

Any of:

string(Bepro Club Name En)

data[].bepro_team_idBepro Team Id (integer) or Bepro Team Id (null)(Bepro Team Id)

Any of:

integer(Bepro Team Id)

data[].bepro_team_nameBepro Team Name (string) or Bepro Team Name (null)(Bepro Team Name)

Any of:

string(Bepro Team Name)

data[].bepro_team_name_enBepro Team Name En (string) or Bepro Team Name En (null)(Bepro Team Name En)

Any of:

string(Bepro Team Name En)

Response

application/json

{
  "count": 0,
  "next": "string",
  "prev": "string",
  "data": [
    { … }
  ]
}

Bepro Data API (2.0.0)

Overview

Authentication

Rate Limits

Event Definition

Coordinates

Version History

Meta

Data

Video

External

Get External Clubs

RequestExpand all

Responses

Get External Leagues

RequestExpand all

Responses

Get External Matches

RequestExpand all

Responses

Get External Players

RequestExpand all

Responses

Get External Seasons

RequestExpand all

Responses

Get External Teams

RequestExpand all

Responses

Request

Request

Request

Request

Request

Request