,The starting point of most betting applications is an overview of all the bookmakers available. The Bookmakers endpoints will help you set up odds properly in your website/application. This endpoint is very useful for administrative purposes to check and structure the bookmakers' availability.
This section will briefly discuss all the options available to request bookmakers.
An overview of all the options available:
- GET All Bookmakers: returns all the bookmakers available in our football API.
- GET Bookmakers by ID: returns bookmakers' information from your requested bookmaker id.
- GET Bookmakers by Fixture ID: returns all the bookmakers available for your requested fixture id.
- GET Bookmaker Event ID's by Fixture ID: returns all the bookmaker event ids available for your requested fixture id.
For all the bookmaker endpoints the base URL is the same:
Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.
*Important: Please note that the domain in the URL is odds instead of football.
The first option is to request all the bookmakers available in our APIs. With this information, you can determine if the bookmakers you’re interested in are available.
Let’s take a look together at what the API returns. You can see the id of the bookmaker, the legacy id (what the bookmaker id was in our old API), and the bookmaker's name.
Now you’ve gathered an overview of the available bookmakers with their unique, you can use this id on the Bookmakers by ID endpoint.
This endpoint returns bookmakers' information from your requested bookmaker ID. All you’ve to do is add the unique id of the bookmaker you want.
For example, if you’re interested in bet365 (id: 2):
The previous mentioned endpoints are extremely convenient for displaying information about all bookmakers or one specific bookmaker. However, it does not indicate if the bookmaker has odds available for the fixtures you’re interested in. You can use the next endpoint for this.
Looking for the available bookmakers of a specific fixture? The GET All Bookmakers by Fixture ID returns all the bookmakers available for your requested fixture id. You will need to add the
fixture_idto your request:
For example, if you’re interested in the bookmakers available for Celtic vs Rangers (fixture id: 18535517)
A lot of our customers want to link the fixture from our APIs to the fixture event of the bookmakers. To help you with this, we’ve integrated the GET Bookmaker Event ID’s by Fixture ID. This endpoint returns all the bookmaker event ids available for your requested fixture.
You will need to add the fixture id and mapping parameter to your request:
For example, if you’re interested in the bookmakers and their event ids for Celtic vs Rangers (fixture id: 18535517)
Please note that for now, we only have the event id’s of bet365 and 22bet available. Therefore you will not see other bookmakers in the response. We're working on other bookmakers as well.
There are no include options available for the bookmaker endpoints.
In our filtering tutorial you’ve learnt how to select specific fields or filter only on the data you’re interested in. By default, our API returns a set of data related to the bookmaker. We can imagine you’re not interested in all the bookmaker data the API returns. Let’s say you’re only interested in the name.
You can add the
&select=parameter followed by the fields you want. In our case:
name. This results in the below request and response: