Bookmakers API and odds API documentation Server All requests pass to our original project spoyer.com , so the address in requests is specified used this domain.
Query structure Use the following line to get data in JSON format:
(
command sequence can be any, separated by & )
http://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=command
General information Each time you use the API, you get information about the speed of data processing , the number of requests per hour in your tariff, their balance and the validity period of the key. The number of requests is counted from the beginning of a new hour.
Bet365 Bet365 is the leader in the betting industry and the most technologically betting company. We are their official partners, and we get API data on all sports, all leagues, all events that are on Bet365 with the fastest possible time (from 0.1 seconds).
Official explanation of requests from Bet365. Download PDF. All bet365 live games:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=bet365live
Bet365 live games for 1 sport only:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=live &bookmaker=bet365 &sport=soccer
Live odds
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=liveodds &bookmaker=bet365 &game_id=90813885
All bet365 prematch games:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=pre &bookmaker=bet365 &sport=basketball
Prematch Odds:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=preodds &bookmaker=bet365 &game_id=90813885
Game results:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=result &bookmaker=bet365 &game_id=90813885
Supported sports Sport Requests name Russian name Soccer soccer Футбол Basketball basketball Баскетбол Ice Hockey icehockey Хоккей Tennis tennis Теннис Badminton badminton Бадминтон Volleyball volleyball Волейбол Table Tennis tabletennis Настольный теннис Cricket cricket Крикет Rugby Union rugbyunion Регби (молодежка) Boxing/UFC boxing Бокс / UFC American Football football Американский футбол Snooker snooker Снукер Darts darts Дартс Baseball baseball Бейсбол Rugby League rugbyleague Регби Australian Rules australianrules Австралийский футбол Bowls bowls Боулинг Gaelic Sports gaelicfootball Гэльский спорт Handball handball Гандбол Futsal futsal Футзал Floorball floorball Флорбол Beach Volleyball beachvolleyball Пляжный Волейбол Water Polo waterpolo Водное поло Squash squash Сквош E-sport esport Кибер-Спорт
1xBet Data on 1xBet including their subsidiaries are divided into two groups. The first group is requests whose IDs are associated with the sports data system, the second group displays all data on 1xBet. Before working with data, check out their documentation at the links below:
Documentation (russian language) ID Descriptions There are also many subsidiaries in the 1xBet bookmaker: Melbet, BetWinner, 1xBet and others, so their line is almost identical to the 1xBet line.
First group Prematch:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=1xpre &sport=soccer &page=1
&page=1 is used to get data on other pages. By default, 50 games are displayed on 1 page. Live:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=1xlive &sport=soccer
Odds:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=1xevent &game_id=ID
Results:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=1xresult &game_id=ID
Second group Display all live games with odds:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=1xliveall
Display all prematch games with odds:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=1xpreall
Supported sports for the first group Sport Requests name Soccer soccer Volleyball volleyball Ice Hockey icehockey Basketball basketball
Bet Exchange (BetFair) We provide betting exchange data with "personal" and "development" license. The difference between licenses is in the speed of updating data and their volume.
Personal license Prematch:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=betexchangepre &p=1
&p=1 is used to get data from other pages. By default, 50 games are displayed on 1 page. Live:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=betexchangelive &p=1
&p=1 is used to get data from other pages. By default, 50 games are displayed on 1 page. Game data (odds, markets, summ):
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=betexchange &game_id=ID
License "development" The data API for this type of license is currently being updated, and requests for this group, for new customers, are temporarily not available. If you need a demo please contact us.
Prematch:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=betexchangepre2v
Live:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=betexchangelive2v
Fonbet Fonbet is the largest Russian betting company. We provide the main line of all sports.
Prematch:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=fonpre
Live:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=fonlive
Unibet The betting company Unibet includes several subsidiaries: 888sport and PlayCity, so their line is almost identical to the Unibet line. We provide the whole line of these companies in all sports in Russian and English.
Get list of supported sports:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=unilistru
Prematch:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=unipre &sport=soccer
To get data in Russian, use the command unipreru
Live:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=unilive
To get data in Russian, use the command uniliveru
Information and odds:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=uniodds &game_id=id
Asian bookmakers odds Since August 2022, we have been cooperating with a data provider for Asian and English betting companies, including Pinnacle, Crown, Sbobet, 188Bet, Mansion88, William Hill, Bet365, and others.
Form documentation and clarifications are currently only available: for games / by odds . The data is presented as is, in the original (from the API provider) and selectively by market (our requests). Using our requests, which already immediately get the type of bets, you can not use the documentation, as there are intuitive and unloaded forms/data.
Requests are divided into two groups - odds and a list of matches, the games in both groups are linked by id. When getting information about the game, you can find the corresponding odds by this ID.
List of games:
Today's games:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=soccergameslive
Games on a specific date:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=soccergames &day=2022-04-04
Basic data with game time:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=asianmatchtime
Odds:
Odds by bet type:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=asian_europeodds
Handicap (FT/HT): asian_handicap, asian_handicaphalf, Total (FT/HT): asian_overunder, asian_overunderhalf Odds (original):
All games:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=asianodds
Live only:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=asianlive
Notes Databases DB with a list of all leagues and teams in
Russian and
English .
Match statuses # Value 0 Not started 1 In game (live) 2 Fixed game* 3 Finished 4 Delayed / Forfeited ** 5 Canceled 6 Won due to no-show 7 Interrupted 8 Interrupted and will not be finished
* - according to Federbet
** - if the score is 3-0 or 0-3
Supported sports Sport Name Russian name Soccer soccer Футбол Basketball basketball Баскетбол Ice Hockey icehockey Хоккей Tennis tennis Теннис Badminton badminton Бадминтон Volleyball volleyball Волейбол Table Tennis tabletennis Настольный теннис Cricket cricket Крикет Rugby Union rugbyunion Регби (молодежка) Boxing/UFC boxing Бокс / UFC American Football football Американский футбол Snooker snooker Снукер Darts darts Дартс Baseball baseball Бейсбол Rugby League rugbyleague Регби Australian Rules australianrules Австралийский футбол Bowls bowls Боулинг Gaelic Sports gaelicfootball Гэльский спорт Handball handball Гандбол Futsal futsal Футзал Floorball floorball Флорбол Beach Volleyball beachvolleyball Пляжный волейбол Water Polo waterpolo Водное поло Squash squash Сквош E-sport esport Кибер-Спорт
Errors Error Reason No parameter 'login' The Login parameter was not specified No parameter 'token' Token parameter not specified No parameter 'task' Task parameter was not specified Login 'your_login' not found Invalid Login parameter Token 'your_token' not valid Invalid Token parameter Token 'your_token' does not work (2020/06/24 15:03:16). Buy new token Your token (key) expired on June 24, 2020 at 15:03:16 Command 'command' is not exist The task=command you specified does not exist Access denied for this command This token (key) is forbidden from using this command Too many requests The number of requests in 1 hour for your token (key) has exceeded the allowable limit Parameter 'day' not exist. Enter the date in YYYYMMDD format, for example day=20200624. Or day=today The day parameter is required and must be in YYYYMMDD format, i.e. 4-digit year, month and day. For example, 20200624 (June 24, 2020). You can also specify day=today (case insensitive) to get today's list of prematch games. The date must have 8 digits. Enter the date in YYYYMMDD format, for example day=20200624 The date must be 8 digits. The detailed date format is described in the line above This is an incorrect date. Enter the date in YYYYMMDD format, for example day=20200624 Invalid or non-existent date. For example, January 32. Enter today's date or later. Format YYYYMMDD. For example day=20200624 or day=today Enter today's date or later. This error will occur when trying to get yesterday's or older games. Parameter 'game_id' no exist. For example game_id=2071852 Missing game_id parameter. The 'game_id' parameter must contain 7/8 digits Parameter game_id must contain 7/8 digits PARAM_INVALID Invalid parameter game_id Parameter 'day/league/team' not exist. Parameter day/league/team not specified / not found The 'league' and 'team' parameters should not be used with the 'day' parameter The league or team parameter must be specified without the 'day' parameter This bookmaker not found or access denied Raised when trying to get the data of a non-existent or unsupported bookmaker for your key You can't use the task=odds and bookmaker commands simultaneously You cannot use the task=odds and bookmaker commands at the same time Parameter 'sport' not exist Parameter sport not found Incorrect sport You must specify the correct value for the sport parameter error site. Send system administrator (In) In 95% of cases, this is an error, due to miss of access rights. For example, you want to view basketball scores when your key only has football rights.
Odds for bookmakers: Sbobet, 10Bet, BWin, 888Sport, 188Bet, CloudBet, BetVictor, Betsson, William Hill, Ladbrokes, provided for football and major markets only - handicap, total, win.
First, you need to get a game ID. To do this, you need to send a request to get prematch or live games. Then, using these IDs, we send a request to get odds for these games.
Live Games http://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=live &sport=soccer
Prematch game *You must specify the date in YYYYMMDD format or use the today parameter (today's date).
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=predata &sport=soccer &day=today
Prematch by page *You must specify the date in YYYYMMDD format or use the today parameter (today's date).
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=predatapage &sport=soccer &day=today &p=1
Displays only 50 games per page, but page generation speed takes from 0.01 seconds. To get data on other pages, use additional requests:
&p=2 etc.
Finished games *You must specify the date in YYYYMMDD format or use the today parameter (today's date).
https://spoyer.com/api/en/get.php?login =your_login &token=your_token &task=enddata &sport=soccer &day=today
Odds Now using game IDs, you can send a request to get odds, for this use this request:
https://spoyer.com/api/en/get.php?login=your_login &token=your_token &task=odds &game_id=2393776
@redpioneer
38(063)06-06-606
sales.spoyer@gmail.com
Ukraine, Kiev, Lev Tolstoy street 3.
Русский язык 
English language