# Bookmaker Deep Links

2024-September-22

Deep links to bookmaker websites are now available in the API.

The /odds and /events/odds endpoints support the following parameters:

includeLinks If "true", the response will include bookmaker links to events, markets, and betslips if available. Valid values are "true" or "false"
includeSids If "true", the response will include source ids (bookmaker ids) for events, markets and outcomes if available. Valid values are "true" or "false". This field can be useful to construct your own links to handle variations in state or mobile app links.

Example Request

https://api.the-odds-api.com/v4/sports/baseball_mlb/odds?apiKey=YOUR_API_KEY&oddsFormat=american&markets=h2h&regions=us&includeLinks=true&includeSids=true

Example Response

[
  {
    "id": "c4b874cffbbc81ae41e455358e14453c",
    "sport_key": "baseball_mlb",
    "sport_title": "MLB",
    "commence_time": "2024-09-24T01:41:00Z",
    "home_team": "Arizona Diamondbacks",
    "away_team": "San Francisco Giants",
    "bookmakers": [
      {
        "key": "fanduel",
        "title": "FanDuel",
        "last_update": "2024-09-23T02:26:27Z",
        "link": "https://sportsbook.fanduel.com/baseball/mlb/san-francisco-giants-%28h-birdsong%29-%40-arizona-diamondbacks-%28e-rodriguez%29-33617147",
        "sid": "33617147",
        "markets": [
          {
            "key": "h2h",
            "last_update": "2024-09-23T02:26:27Z",
            "link": null,
            "sid": null,
            "outcomes": [
              {
                "name": "Arizona Diamondbacks",
                "price": -172,
                "link": "https://sportsbook.fanduel.com/addToBetslip?marketId=42.448600011&selectionId=29165",
                "sid": "29165"
              },
              {
                "name": "San Francisco Giants",
                "price": 144,
                "link": "https://sportsbook.fanduel.com/addToBetslip?marketId=42.448600011&selectionId=29178",
                "sid": "29178"
              }
            ]
      ...

The availability of links will depend on the bookmaker. To determine which link to use, the following logic looks for the deepest available link, and falls back on successively shallower links.

if (outcome.link) {
  link = outcome.link

} else if (market.link) {
  link = market.link

} else if (event.link) {
  link = event.link

} else {
  // Fall back on the bookmaker's home page.
  // Bookmaker homepage links are not currently returned in the API and will need to be defined in your app.
  link = 'https://sportsbook.example.com'

}

# Bet Limits

Bet limits are being introduced in the API. These are the monetary amounts available for betting on a given odds selection, and are mostly applicable to betting exchanges. The currency will depend on the region of the betting exchange.

Bet limits can be returned in the API by specifying the following parameter in either the /odds or /events/odds endpoints:

includeBetLimits If "true", the response will include the bet limit of each betting option, mainly available for betting exchanges. Valid values are "true" or "false"

Example Request

https://api.the-odds-api.com/v4/sports/soccer_epl/odds?apiKey=YOUR_API_KEY&bookmakers=betfair_ex_uk&markets=h2h&includeBetLimits=true

Example Response

[
  {
    "id": "763235c932169620bd3d90dfef7d8403",
    "sport_key": "soccer_epl",
    "sport_title": "EPL",
    "commence_time": "2024-09-28T11:30:00Z",
    "home_team": "Newcastle United",
    "away_team": "Manchester City",
    "bookmakers": [
      {
        "key": "betfair_ex_uk",
        "title": "Betfair",
        "last_update": "2024-09-23T02:34:08Z",
        "markets": [
          {
            "key": "h2h",
            "last_update": "2024-09-23T02:34:08Z",
            "outcomes": [
              {
                "name": "Manchester City",
                "price": 1.65,
                "bet_limit": 76
              },
              {
                "name": "Newcastle United",
                "price": 5.4,
                "bet_limit": 17
              },
              {
                "name": "Draw",
                "price": 4.7,
                "bet_limit": 105
              }
            ]
          },
        ...

# Get Started

For more info on getting started, see the docs.

To get started with a free API key, see our plans.