Get Betting Trends

Retrieve betting trends with statistical patterns and odds

GET /bets/trends

Betting Trends

cURL

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

Overview

Returns betting trends based on historical statistical patterns for upcoming matches. Trends highlight patterns like “Under 3.5 Goals - 12/13 Last Matches” with associated odds and confidence levels.

Cache TTL: Variable (typically short for fresh trend data)

Parameters

sportType · integer · required

Sport type ID. Use 1 for Football

date · string · required

Date in DD/MM/YYYY format (e.g., “18/12/2025”)

isTop · boolean

Filter to show only top/high-confidence trends. Default: true

topBookmaker · integer

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

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

Response Structure

lastUpdateId · integer

Internal versioning ID for caching or incremental updates

ttl · integer

Time To Live in seconds

trends · array

Array of betting trend objects

Show Trend Object

id · integer

Unique trend identifier

lineTypeId · integer

Bet line type (1=Match Result, 3=Over/Under, 12=Both Teams Score)

text · string

Human-readable trend description (e.g., “Under 3.5 Goals - 12/13 Last Matches”)

cause · string

Short description of the trend pattern

isTop · boolean

Whether this is a high-confidence top trend

betCTA · string

Call-to-action text for the bet (e.g., “Under”, “Over”, “Both Teams To Score”)

gameId · integer

Associated game/match ID

competitorIds · array

Array of competitor IDs this trend applies to

percentage · number

Success rate as decimal (e.g., 0.923 = 92.3%)

odds · object

Betting odds for this trend

Show Trend Odds

num · integer

Option number

rate · object

Current odds in decimal, fractional, and american formats

oldRate · object

Previous odds (for tracking movement)

originalRate · object

Opening odds

trend · integer

Odds movement: 1=decreased, 2=unchanged, 3=increased

bookmakerId · integer

Bookmaker ID for these odds

confidenceTrendIds · array

IDs of related trends that support this prediction

isGeneralGameBet · boolean

Whether this applies to the whole game vs specific team

bookmakers · array

Referenced bookmaker objects with branding info

games · array

Associated game objects with match details

sports · array

Referenced sport objects

countries · array

Referenced country objects

competitions · array

Referenced competition objects

competitors · array

Referenced competitor/team objects

Request Example

cURL

curl -X GET "https://v1.football.sportsapipro.com/trends?sportType=1&date=18/12/2025&isTop=true&topBookmaker=14" \
  -H "x-api-key: YOUR_API_KEY"

Response Example

{
  "lastUpdateId": 0,
  "ttl": 0,
  "trends": [
    {
      "id": 11075397,
      "lineTypeId": 3,
      "text": "Under 3.5 Goals - 12/13 Last Matches",
      "cause": "Under 3.5 Goals",
      "isTop": true,
      "betCTA": "Under",
      "divId": 11075397,
      "competitorIds": [10],
      "gameId": 4538919,
      "odds": {
        "num": 1,
        "rate": {
          "decimal": 1.67,
          "fractional": "2/3",
          "american": "-149"
        },
        "bookmakerId": 14,
        "oldRate": {
          "decimal": 1.62,
          "fractional": "5/8",
          "american": "-161"
        },
        "originalRate": {
          "decimal": 1.83,
          "fractional": "5/6",
          "american": "-120"
        },
        "trend": 3
      },
      "bookmakerId": 14,
      "confidenceTrendIds": [11075398],
      "isGeneralGameBet": true,
      "percentage": 0.9230769230769231
    },
    {
      "id": 10515589,
      "lineTypeId": 12,
      "text": "Both teams scored - 3/4 Last Matches",
      "cause": "Both teams scored",
      "betCTA": "Both Teams To Score",
      "divId": 10515589,
      "competitorIds": [1956],
      "gameId": 4538918,
      "odds": {
        "num": 1,
        "rate": {
          "decimal": 1.53,
          "fractional": "8/15",
          "american": "-189"
        },
        "bookmakerId": 14,
        "trend": 1
      },
      "bookmakerId": 14,
      "confidenceTrendIds": [10417664],
      "isGeneralGameBet": true,
      "percentage": 0.75
    }
  ],
  "bookmakers": [
    {
      "id": 14,
      "name": "Bet365",
      "link": "https://extra.bet365.com/features/en/sports-live-streaming",
      "nameForURL": "bet365",
      "color": "#007B5B",
      "imageVersion": 3,
      "promotionText": "Sign up at bet365 today",
      "actionButton": {
        "link": "https://www.bet365.com/olp/open-account",
        "label": "Bet Now"
      }
    }
  ],
  "sports": [...],
  "countries": [...],
  "competitions": [...],
  "competitors": [...],
  "games": [...]
}

Line Type IDs Reference

ID	Type	Description
1	Match Result	Win/Lose outcome
3	Over/Under	Total goals over/under threshold
12	BTTS	Both Teams To Score

Key Fields Reference

Percentage Field

The percentage field represents the historical success rate:

• 1.0 = 100% (e.g., “8/8 Last Matches”)
• 0.923 = 92.3% (e.g., “12/13 Last Matches”)
• 0.75 = 75% (e.g., “3/4 Last Matches”)

Confidence Trends

The confidenceTrendIds array links related trends that support the same prediction, allowing you to show multiple supporting statistics.

Use Cases

• Display betting insights based on statistical patterns
• Build trend-based prediction features
• Show historical success rates for different bet types
• Track odds movements with trend indicators
• Create “value bet” recommendations based on high-percentage trends

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

gameId · integer · required

Game identifier

Example:

4609057

matchupId · string · required

Matchup identifier

Example:

"14-106-9"

Response

200

Betting trends retrieved successfully