Scottish Premiership Odds API ​

The Odds API covers Scottish Premiership odds for live and upcoming matches in a simple JSON API.

Not a developer? Current Scottish Premiership odds can also be accessed in Excel or Google Sheets. For website owners, the odds widget brings bookmaker odds into websites with a simple HTML tag.

Features ​

  • Scottish Premiership odds are covered for live and upcoming matches.

  • Featured markets, including 1X2, handicap, over/under are covered for several bookmakers. See the full list of bookmakers.

  • Odds are refreshed at regular intervals. More information on update intervals can be found here.

  • Scottish Premiership scores are covered, with final scores available for matches completed up to 3 days ago.

  • Current odds data and scores are available on all usage plans, including the free usage plan.

  • Historical Scottish Premiership odds data is available from Jul 2020 on paid usage plans. More information on historical odds data can be found here.

  • The API response includes deep links to bookmaker websites.

Querying Scottish Premiership Odds ​

Featured markets (1X2, handicap and over/under) can be queried using the odds endpoint.

Parameters

To query current Scottish Premiership odds for featured markets, the following parameters need to be provided:

  • sport   In this case soccer_spl
  • regions   Regions of bookmakers to return, for example uk
  • markets   For example, h2h for 1X2, spreads for handicap, totals for over/under
  • oddsFormat   decimal or american. This example uses decimal
  • apiKey   Get a free API key

See the documentation for more options

Example API Request

https://api.the-odds-api.com/v4/sports/soccer_spl/odds?regions=uk&markets=h2h,spreads,totals&oddsFormat=decimal&apiKey=YOUR_API_KEY

Example API Response

The API will return live and upcoming Scottish Premiership matches, including start times, home and away teams, and odds from bookmakers for the specified regions and markets.

json
[{
    "id": "f796c10282bb7bd80ea9889d03d2066d",
    "sport_key": "soccer_spl",
    "sport_title": "Premiership - Scotland",
    "commence_time": "2026-11-07T15:00:00Z",
    "home_team": "St Johnstone",
    "away_team": "Dundee FC",
    "bookmakers": [
        {
            "key": "matchbook",
            "title": "Matchbook",
            "last_update": "2026-11-06T11:55:18Z",
            "markets": [
                {
                    "key": "h2h",
                    "last_update": "2026-11-06T11:55:18Z",
                    "outcomes": [
                        {"name": "Dundee FC", "price": 2.72},
                        {"name": "St Johnstone", "price": 2.46},
                        {"name": "Draw", "price": 3.65}
                    ]
                },
                {
                    "key": "spreads",
                    "last_update": "2026-11-06T11:55:18Z",
                    "outcomes": [
                        {"name": "Dundee FC", "price": 1.98, "point": 0},
                        {"name": "St Johnstone", "price": 1.81, "point": 0}
                    ]
                },
                {
                    "key": "totals",
                    "last_update": "2026-11-06T11:55:18Z",
                    "outcomes": [
                        {"name": "Over", "price": 1.77, "point": 2.5},
                        {"name": "Under", "price": 2.14, "point": 2.5}
                    ]
                }
            ]
        },
        ...

The usage cost of the API call in this example is

usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits

See the API documentation for details.

Other Sports ​

See the full list of sports covered by The Odds API.

Stay Updated ​

Follow us on X.com or Bluesky to stay updated on new sports, bookmakers, markets and features.

X.com • Bluesky • Github
Status • Terms • Privacy Policy • Contact
⚠️ Impersonator Warning
© 2026 The Odds API