Sports Feeds

This document illustrates the sports feeds data request parameters, endpoint and the data returned.

All major sports and leagues are supported. For custom requests, reach out to the Gora team for inclusion.

Available Endpoints

Odds

• Betting Odds (including home/away, spread, and over/unders).

Boxscores

• Team and Player statistics

API Call

Game Odds

Base Url: https://sports-feeds.gora.io

Get Odds: GET /api/v4/game-odds

Parameters:

Name	Type	Description	Example
region	string	(required) The region where the sport is being played. The available regions are: world, europe, africa, asia, usa, england, germany, italy, spain, france	europe
sport	string	(required) The category of sports: soccer, basketball, american football	soccer
league	string	(required) The league the sport is being played. E.g. epl (English Premier League), itsa (Italian Serie A), esp (Spanish Premier Division), deb (German Bundesliga), frl1 (French Ligue 1), nba (National Basketball Association)	epl
date	string	(required) The date the game is being played. Date format is YYYY-MM-DD	2023-05-28
homeTeam	string	(required) The short name or full name of the home team.	arsenal
key	string	(required) Key provided by GoraNetwork. When using node runner set the key as ##signKey	##signKey

Example Call

https://sports-feeds.gora.io/api/v4/game-odds?key=##signKey&region=england&sport=soccer&league=epl&date=2023-05-28&homeTeam=arsenal

Example Response (JSON)

{
    "status": 200,
    "result": "success",
    "description": "Successfully fetched Data Sports Group Odds",
    "query": {
        "region": "england",
        "sport": "soccer",
        "league": "epl",
        "date": "2023-05-28",
        "homeTeam": "arsenal"
    },
    "provider": {
        "name": "Data Sports Group",
        "subscription": true,
        "institutionGrade": true
    },
    "data": {
        "startTime": 1685287800000,
        "status": 3,
        "awayTeamName": "Arsenal FC",
        "homeTeamName": "Wolverhampton Wanderers FC",
        "homeTeamScore": 5,
        "awayTeamScore": 0,
        "homeMoneyLine": 2.02,
        "awayMoneyLine": 9.5,
        "drawMoneyLine": 6
    },
    "time": "Mon, 26 Jun 2023 14:47:43 GMT",
    "timestamp": 1687790863821,
    "lastUpdated": 1687790863821
}

Results Schema

Game Boxscores

Base Url: https://sports-feeds.gora.io

Get Boxscores: GET /api/v4/boxscores

Parameters:

Example Call

https://sports-feeds.gora.io/api/v4/boxscores?key=##signKey&region=england&sport=soccer&league=epl&date=2023-05-28&homeTeam=arsenal

Example Response (JSON)

{
    "status": 200,
    "result": "success",
    "description": "Successfully fetched Data Sports Group Odds",
    "query": {
        "region": "england",
        "sport": "soccer",
        "league": "epl",
        "date": "2023-05-28",
        "homeTeam": "Arsenal"
    },
    "provider": {
        "name": "Data Sports Group",
        "subscription": true,
        "institutionGrade": true
    },
    "data": {
        "eventId": "2701468",
        "sideAName": "Arsenal FC",
        "sideBName": "Wolverhampton Wanderers FC",
        "sideAScore": 5,
        "sideBScore": 0,
        "periodResults": {
            "firstPeriod": {
                "period": "1st Period",
                "sideAScore": 3,
                "sideBScore": 0
            },
            "secondPeriod": {
                "period": "2nd Period",
                "sideAScore": 2,
                "sideBScore": 0
            }
        }
    },
    "time": "Tue, 27 Jun 2023 17:07:17 GMT",
    "timestamp": 1687885637346,
    "lastUpdated": 1687885637346
}

Results Schema

Player Stats

Base Url: https://sports-feeds.gora.io

Get Odds: GET /api/v4/boxscores/players

Parameters:

Example Call

https://sports-feeds.gora.io/api/v4/boxscores/players?key=##signKey&region=england&sport=soccer&league=epl&date=2023-05-28&homeTeam=arsenal&player=saka

Example Response (JSON)

{
    "status": 200,
    "result": "success",
    "description": "Successfully fetched Data Sports Group Player Boxscores",
    "query": {
        "region": "england",
        "sport": "soccer",
        "league": "epl",
        "date": "2023-05-28",
        "homeTeam": "arsenal",
        "player": "saka"
    },
    "provider": {
        "name": "Data Sports Group",
        "subscription": true,
        "institutionGrade": true
    },
    "data": {
        "statId": "2701468_252100",
        "playerId": "252100",
        "name": "Bukayo Saka",
        "teamName": "Arsenal FC",
        "minutes": null,
        "goals": 1,
        "assists": 0,
        "shots": null,
        "shotsOnGoal": null,
        "yellowCards": 0,
        "redCards": 0,
        "crosses": null,
        "tacklesWon": null,
        "interceptions": null,
        "ownGoals": null,
        "fouls": null,
        "fouled": null,
        "offsides": null,
        "passes": null,
        "passesCompleted": null,
        "lastManTackle": null,
        "cornersWon": null,
        "blockedShots": null,
        "touches": null,
        "defenderCleanSheets": null,
        "goalkeeperSaves": null,
        "goalkeeperGoalsAgainst": null,
        "penaltyKickGoals": null,
        "penaltyKickMisses": null,
        "penaltyKickSaves": null,
        "penaltiesWon": null,
        "penaltiesConceded": null
    },
    "time": "Mon, 10 Jul 2023 17:05:06 GMT",
    "timestamp": 1689008706231,
    "lastUpdated": 1689008706231
}

Results Schema