Sport API
The Sport API exposes comprehensive API for managing sport content, users and teams.
Get Scores
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/scores
Method return list of games related to user's followed teams (in case sent as competitors list) In case competitions parameter is used, list of games for the competition returns regardless of user's followed teams.
Query Parameters
period
integer
Date period (e.g if=3 means 3 days before today until 3 days after today)
competitors
string
comma separated competitor ids
competitions
string
comma separated competition ids
sportType
string
type of sport (e.g. soccer)
limit
integer
Limits the number of games returned
endDate
string
Date/time format is: "MM/dd/yyyy" Default is 7 days ahead.
startDate
string
Date/time format is: "MM/dd/yyyy" Default is 7 days ago.
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android Application
aid
string
Mandatory in case of android application
{
games: [
{
gameId: 1185419,
sportTypeName: "Soccer",
leageName: "Champions League",
season: "2016/2017",
status: "ENDED",
GT: "90'",
gameTime: "1492015500",
teams: [
{
teamId: 331,
teamName: "Bayern Munich",
teamLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_competitors_default1.png/http://res.cloudinary.com/scores365/image/upload/Competitors/331",
sportTypeId: 1,
isSelected: false
},
{
teamId: 131,
teamName: "Real Madrid",
teamLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_competitors_default1.png/http://res.cloudinary.com/scores365/image/upload/Competitors/131",
sportTypeId: 1,
isSelected: false
}
],
scores: [
{
teamId: 331,
score: 1
},
{
teamId: 131,
score: 2
}
]
}
]
userCountry: -1,
userLanguage: 1,
timeZone: 1,
userTeams: "331,131,158"
}
Get Content
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/content
The sport API will return content data as requested: In case content related to user's followed teams is required, use the "competitors" parameter.
Query Parameters
competitors
string
comma separated competitor ids
competitions
string
comma separated competition ids
sportType
string
Type of sport (e.g. soccer)
offset
integer
Use the "nextContentItem" which is part of the returned JSON to set the offset for the next request.
limit
integer
Up to 20 content items per request Default = 10
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Get Content by id
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/content/{id}
The sport API will return content data as requested for specific content id.
Path Parameters
id
integer
Specific article id
Query Parameters
competitions
string
comma separated competition list
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Get Game Data
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/game/{id}
The sport API will return game data as requested.
Path Parameters
id
integer
Specific game id
Query Parameters
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Get Teams Data
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/team/data
The sport API will return teams data as requested.
Query Parameters
sportType
string
Type of sport (e.g. soccer)
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Team Search
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/team/search
The sport API will return team search results as requested. The returned list consists of sport types and list of teams for each of the types.
Query Parameters
sportType
string
Type of sport (e.g soccer)
search
string
Search string (can be part of team's name) E.g. in case parameter is 'barcelo', all Barcelona teams from all different sport types will be returned.
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Get League
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/league
The sport API will return list of leagues as requested for specific country. The returned list consists of sport type and for each type list of leagues.
Query Parameters
sportType
string
Type of sport (e.g. soccer)
countryId
integer
The country id returned from team/data API
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Get League Teams
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/league/{id}/teams
The sport API will return list of teams as requested for specific league.
Path Parameters
id
integer
Specific league id
Query Parameters
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Follow Team
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/user/{userId}/teams/{teamId}/add
The sport API adds selected team to user. API returns user's teams as JSON.
Path Parameters
teamId
integer
Specific team id
userId
string
Source user id (UUID)
Query Parameters
competitions
string
competition id (the return team list is only from this competition)
sportType
string
Type of sport (e.g. soccer)
countryId
integer
Country id of the team being added
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Unfollow team
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/user/{userId}/teams/{teamId}/delete
The sport API deletes user's followed team. API returns user's teams as JSON.
Path Parameters
teamId
integer
Specific team id
userId
string
Source user id (UUID)
Query Parameters
competitions
string
competition id (the return team list is only from this competition)
sportType
string
Type of sport (e.g. soccer)
language
string
2 letter language code (ISO 639-1)
optOut
boolean
Allowed values are: true/false Mandatory in case of android application
aid
string
Mandatory in case of android application
Get game list
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/games
Method returns list of games for sport type and language. Among game attributes the response contains magazine game page URL. In case specific competition or specific competitor is set, do not add sportType nor countryCode to the request. API support soccer and basketball sport types.
Query Parameters
period
integer
period in days (X days before today until X days after today)
limit
integer
limit the number of return games (default=30)
language
string
2 letter country code (ISO 639-1)
aid
string
Mandatory in case of Android application
optOut
boolean
Allowed values are: true/false Mandatory in case of Android application
competitors
string
comma separated team ids
competitions
string
comma separated competition ids (e.g league id)
endDate
string
Date format is MM/dd/yyyy Default is 7 days ahead
startDate
string
Date format is MM/dd/yyyy Default is 7 days back
countryCode
string
2 letter country code (ISO-ALPHA-2)
sportType
string
Supported types of sport (soccer, basketball)
Get cricket game list
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/cricket
Method returns list of cricket games. among other attributes response contains game page URL Response is in English.
Query Parameters
optOut
boolean
Mandatory in case of Android application
aid
string
Mandatory in case of Android application
offset
integer
the offset needed
sortBy
string
sort the return list by time of game (asc or desc)
limit
integer
limit the number of return games (default=30)
endDate
string
Date format is MM/dd/yyyy Default is 7 days ahead
startDate
string
Date format is MM/dd/yyyy Default is 7 days back
competitors
string
comma separated team ids
competitions
string
comma separated competition ids (e.g league id)
Get specific cricket game
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/cricket/{id}
Method returns specific cricket game data. Response is in English.
Path Parameters
id
integer
cricket game id
Query Parameters
optOut
boolean
Mandatory in case of Android application
aid
string
Mandatory in case of Android application
Get Player
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/player/{id}
Method returns specific player personal data and statistics data for specific competition (competition can be league or cap)
Path Parameters
id
integer
Player id
Query Parameters
optOut
string
Mandatory in case of android application
aid
string
Mandatory in case of android application
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
competitionId
string
the specific competition id (e.g. league)
Get team roster
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/team/roster
Method returns roster for team and player's statistics for selected competition
Query Parameters
optOut
string
Mandatory in case of android application
aid
string
Mandatory in case of android application
language
string
2 letter language code (ISO 639-1)
countryCode
string
2 letter country code (ISO-ALPHA-2)
teamId
integer
team id
competitionId
integer
competition id
Get competition standing table
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/competition/{competitionId}/table
Method returns standing table with team list. Each team contains it's statistics in selected competition context.
Path Parameters
competitionId
integer
competition id (e.g. 595 Copa America)
Query Parameters
optOut
string
mandatory in case of Android application
aid
string
mandatory in case of Android application
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
Get Game votes (who will win)
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/games/vote
Method returns game list. For each game the response contains who will win users votes.
Query Parameters
period
integer
X days before today until X days after today
competitors
string
comma separator competitor ids
optOut
string
mandatory in case of Android application
aid
string
mandatory in case of Android application
sportType
string
sport type (soccer or basketball)
limit
integer
limit the number of returned games
endDate
string
Date format is MM/dd/yyyy
startDate
string
Date format is MM/dd/yyyy
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
Get competition votes (who will win)
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/competition/{competitionId}/games/vote
Method return game list for specific competition. For each game the response contains "who will win" user's votes.
Path Parameters
competitionId
integer
competition id
Query Parameters
period
integer
X days before today until X days after today
limit
string
Number of returned games
endDate
string
Date format MM/dd/yyyy
startDate
string
Date format MM/dd/yyyy
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
Get team statistics
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/team/{id}/stats
Method returns team statistics in specific competition
Path Parameters
id
string
team id
Query Parameters
competitionId
integer
competition id
countryCode
string
2 letter country code
language
string
2 letter language
Get popular teams
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/team/popular
Method returns list of popular teams for sport type and country.
Query Parameters
limit
integer
number of teams to return
sportType
string
soccer or basket ball
countryCode
string
2 letter country code
language
string
2 letter language
Get competition teams
GET https://sportapi.celltick.com/mediaApi/v1.0/sport/competition/{competitionId}/teams
Method return list of team for specific competition
Path Parameters
competitionId
integer
competition id
Query Parameters
countryCode
string
2 letter country code
language
string
2 letter language code
Last updated