Get Betting Teaser

Retrieve betting odds teaser for a specific game with related matches and bookmaker information.

GET /bets/teaser

Betting Teaser

cURL

curl --request GET \
  --url https://v1.football.sportsapipro.com/bets/teaser \
  --header 'x-api-key: <api-key>'

Overview

The Betting Teaser endpoint provides betting odds for a specific game, along with related matches from the same competition/round. This is useful for displaying pre-match betting information with odds from your preferred bookmaker.

Parameters

gameId · integer · required

The unique game/match identifier to get odds for.

topBookmaker · integer · default: "14"

Preferred bookmaker ID for odds (e.g., 14 for Bet365).

Parameters appTypeId, langId, timezoneName, and userCountryId are automatically resolved by the upstream service. You can override timezoneName with a specific timezone (e.g., America/New_York). All startTime fields use ISO 8601 format with a dynamic timezone offset.

Request

cURL

curl -X GET "https://v1.football.sportsapipro.com/bets/teaser?gameId=4609055&topBookmaker=14" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 1,
      "name": "England",
      "nameForURL": "england",
      "sportTypes": [1, 9, 11],
      "imageVersion": 1,
      "isInternational": false
    }
  ],
  "competitions": [
    {
      "id": 7,
      "countryId": 1,
      "sportId": 1,
      "name": "Premier League",
      "shortName": "EPL",
      "nameForURL": "premier-league",
      "popularityRank": 92856977,
      "imageVersion": 12,
      "color": "#075C9C"
    }
  ],
  "bookmakers": [
    {
      "id": 14,
      "name": "Bet365",
      "link": "https://extra.bet365.com/features/en/sports-live-streaming",
      "nameForURL": "bet365",
      "actionButton": {
        "link": "https://www.bet365.com/olp/open-account",
        "label": "Bet Now"
      },
      "color": "#007B5B",
      "imageVersion": 3,
      "promotionText": "Sign up at bet365 today"
    }
  ],
  "games": [
    {
      "id": 4452715,
      "sportId": 1,
      "competitionId": 7,
      "seasonNum": 131,
      "stageNum": 1,
      "roundNum": 17,
      "roundName": "Round",
      "competitionDisplayName": "Premier League",
      "startTime": "2025-12-20T15:00:00+00:00",
      "statusGroup": 2,
      "statusText": "Scheduled",
      "shortStatusText": "Sched.",
      "homeCompetitor": {
        "id": 110,
        "name": "Manchester City",
        "shortName": "Man City",
        "symbolicName": "MCI",
        "score": -1.0,
        "color": "#ABD1F5",
        "imageVersion": 1
      },
      "awayCompetitor": {
        "id": 113,
        "name": "West Ham United",
        "shortName": "West Ham",
        "symbolicName": "WHU",
        "score": -1.0,
        "color": "#74112E",
        "imageVersion": 7
      },
      "hasStandings": true,
      "winner": 0
    }
  ],
  "odds": [
    {
      "lineId": 1625689226,
      "gameId": 4452715,
      "bookmakerId": 14,
      "lineTypeId": 1,
      "lineType": {
        "id": 1,
        "name": "Full Time Result",
        "shortName": "1X2",
        "title": "Full Time Result",
        "internalOptionType": -1
      },
      "options": [
        {
          "num": 1,
          "name": "1",
          "rate": {
            "decimal": 1.22,
            "fractional": "2/9",
            "american": "-455"
          },
          "oldRate": {
            "decimal": 1.18,
            "fractional": "2/11",
            "american": "-556"
          },
          "originalRate": {
            "decimal": 1.18,
            "fractional": "2/11",
            "american": "-556"
          },
          "trend": 3
        },
        {
          "num": 2,
          "name": "X",
          "rate": {
            "decimal": 7.5,
            "fractional": "13/2",
            "american": "+650"
          },
          "oldRate": {
            "decimal": 8.0,
            "fractional": "7/1",
            "american": "+700"
          },
          "originalRate": {
            "decimal": 6.5,
            "fractional": "11/2",
            "american": "+550"
          },
          "trend": 1
        },
        {
          "num": 3,
          "name": "2",
          "rate": {
            "decimal": 11.0,
            "fractional": "10/1",
            "american": "+1000"
          },
          "oldRate": {
            "decimal": 13.0,
            "fractional": "12/1",
            "american": "+1200"
          },
          "originalRate": {
            "decimal": 13.0,
            "fractional": "12/1",
            "american": "+1200"
          },
          "trend": 1
        }
      ]
    }
  ]
}

Response Fields

Root Level

Field	Type	Description
sports	array	Sport metadata
countries	array	Country metadata
competitions	array	Competition details
bookmakers	array	Bookmaker information with branding
games	array	Related games with match details
odds	array	Betting odds for each game

Bookmaker Object

Field	Type	Description
id	integer	Unique bookmaker identifier
name	string	Bookmaker name (e.g., “Bet365”)
link	string	Bookmaker website link
nameForURL	string	URL-safe name
actionButton	object	CTA button with link and label
color	string	Brand color hex code
imageVersion	integer	Logo image version
promotionText	string	Promotional tagline

Game Object

Field	Type	Description
id	integer	Unique game identifier
sportId	integer	Sport ID
competitionId	integer	Competition ID
seasonNum	integer	Season number
stageNum	integer	Stage number
roundNum	integer	Round number
roundName	string	Round name (e.g., “Round”)
competitionDisplayName	string	Full competition name
startTime	string	ISO 8601 start time with dynamic timezone offset
statusGroup	integer	Status group (1=Not Started, 2=Scheduled, 3=Live, 4=Ended, 5=Cancelled, 6=Postponed, 8=Abandoned)
statusText	string	Human-readable status
shortStatusText	string	Abbreviated status
homeCompetitor	object	Home team details
awayCompetitor	object	Away team details
hasStandings	boolean	Whether standings are available
winner	integer	Winner (0=none/undecided, 1=home, 2=away)

Competitor Object

Field	Type	Description
id	integer	Team unique identifier
name	string	Full team name
shortName	string	Abbreviated name
longName	string	Extended official name
symbolicName	string	3-letter code
score	number	Current score (-1 if not started)
color	string	Primary team color
awayColor	string	Away kit color
imageVersion	integer	Team logo version
mainCompetitionId	integer	Primary competition ID
hasSquad	boolean	Whether squad data is available

Odds Object

Field	Type	Description
lineId	integer	Unique betting line ID
gameId	integer	Associated game ID
bookmakerId	integer	Bookmaker providing the odds
lineTypeId	integer	Bet type ID
lineType	object	Bet type details
options	array	Available betting options

Line Type Object

Field	Type	Description
id	integer	Line type ID
name	string	Full name (e.g., “Full Time Result”)
shortName	string	Abbreviated name (e.g., “1X2”)
title	string	Display title
internalOptionType	integer	Internal option type flag

Odds Option Object

Field	Type	Description
num	integer	Option number (1=Home, 2=Draw, 3=Away)
name	string	Option label (“1”, “X”, “2”)
rate	object	Current odds
oldRate	object	Previous odds for comparison
originalRate	object	Opening odds
trend	integer	Movement: 1=shortened, 2=unchanged, 3=drifted

Rate Object

Field	Type	Description
decimal	number	Decimal odds (e.g., 1.22)
fractional	string	Fractional odds (e.g., “2/9”)
american	string	American odds (e.g., “-455”)

Odds Movement Trends

Value	Meaning	Description
1	Shortened	Odds decreased (more likely outcome)
2	Unchanged	Odds remain the same
3	Drifted	Odds increased (less likely outcome)

Use Cases

• Display pre-match betting odds for a specific game
• Show odds movement with trend indicators
• Build bet slip or odds comparison features
• Display related matches from the same round
• Show bookmaker branding and CTAs

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

gameId · integer · required

Game identifier

Example:

4609057

Response

200

Betting teaser retrieved successfully