# Sport API

## Get Scores

<mark style="color:blue;">`GET`</mark> `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

| Name         | Type    | Description                                                                       |
| ------------ | ------- | --------------------------------------------------------------------------------- |
| 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  | <p>Date/time format is:<br>"MM/dd/yyyy"<br>Default is 7 days ahead.</p>           |
| startDate    | string  | <p>Date/time format is:<br>"MM/dd/yyyy"<br>Default  is 7 days ago.</p>            |
| countryCode  | string  | 2 letter country code (ISO-ALPHA-2)                                               |
| language     | string  | 2 letter language code (ISO 639-1)                                                |
| optOut       | boolean | <p>Allowed values are: true/false<br>Mandatory in case of android Application</p> |
| aid          | string  | Mandatory in case of android application                                          |

{% tabs %}
{% tab title="200 Returned scores example (This example displays one game result)" %}

```
{
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"
}

```

{% endtab %}
{% endtabs %}

## Get Content

<mark style="color:blue;">`GET`</mark> `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

| Name         | Type    | Description                                                                                          |
| ------------ | ------- | ---------------------------------------------------------------------------------------------------- |
| 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 | <p>Up to 20 content items per request <br>Default = 10</p>                                           |
| countryCode  | string  | 2 letter country code (ISO-ALPHA-2)                                                                  |
| language     | string  | 2 letter language code (ISO 639-1)                                                                   |
| optOut       | boolean | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p>                 |
| aid          | string  | Mandatory in case of android application                                                             |

{% tabs %}
{% tab title="200 Returned content example (This example displays one content item)" %}

```
{
totalItems: 1,
content: [
{
id: "66865368",
title: "Barcelona planning to sell several big names this summer - report",
text: "",
contentUrl: "https://www.thestartmagazine.com/365/article/86506032?",
publishTime: "1492015500",
date: "Today, 15:03",
imgUrl: "http://res.cloudinary.com/start4cell/image/fetch/d_articleImage_default.png,f_auto,fl_lossy,q_30,w_480/https%3A%2F%2Fcdn0.vox-cdn.com%2Fthumbor%2FB3_0Lyspk4gcdLJAgbV-bDF2T_I%3D%2F0x0%3A1986x1117%2F1600x900%2Fcdn0.vox-cdn.com%2Fuploads%2Fchorus_image%2Fimage%2F54234241%2F615665428.0.jpg",
imgHeight: 900,
imgWidth: 1600,
relatedTeams [
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/132",
teamId: 132,
isSelected:true
]
isPreview: true,
origURL:”http://www.sport5.co.il/articles.aspx?FolderID=398&docID”
}
],
nextContentItem: "66865368",
userLanguage: 1,
userCountry: -1,
timezone: 1
}

```

{% endtab %}
{% endtabs %}

## Get Content by id

<mark style="color:blue;">`GET`</mark> `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

| Name | Type    | Description         |
| ---- | ------- | ------------------- |
| id   | integer | Specific article id |

#### Query Parameters

| Name         | Type    | Description                                                                          |
| ------------ | ------- | ------------------------------------------------------------------------------------ |
| 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 | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p> |
| aid          | string  | Mandatory in case of android application                                             |

{% tabs %}
{% tab title="200 Returned single article example:" %}

```
{
id: "66645078",
title: "FC Barcelona News: 9 April 2017: Barca Suffer Shock Defeat To Malaga, Squad Announced For Juventus",
text: "",
origURL: "http://www.barcablaugranes.com/2017/4/9/15235272/fc-barcelona-news-9-april-2017-barca-suffer-shock-defeat-to-malaga?utm_source=365Scores&utm_medium=link&utm_campaign=Contact+us+at+365scores+for+more+traffic",
publishTime: "1492015500",
date: "April 9, 14:38",
imgUrl: "http://res.cloudinary.com/start4cell/image/fetch/d_articleImage_default.png,f_auto,fl_lossy,q_30,w_480/https%3A%2F%2Fcdn0.vox-cdn.com%2Fthumbor%2F6omStY7cpQhmImZ6BD3fl4-u1MI%3D%2F0x0%3A4928x2772%2F1600x900%2Fcdn0.vox-cdn.com%2Fuploads%2Fchorus_image%2Fimage%2F54155817%2FGettyImages-664971124.0.jpg",
imgHeight: 900,
imgWidth: 1600,
isPreview: true
}

```

{% endtab %}
{% endtabs %}

## Get Game Data

<mark style="color:blue;">`GET`</mark> `https://sportapi.celltick.com/mediaApi/v1.0/sport/game/{id}`

The sport API will return game data as requested.

#### Path Parameters

| Name | Type    | Description      |
| ---- | ------- | ---------------- |
| id   | integer | Specific game id |

#### Query Parameters

| Name        | Type    | Description                                                                          |
| ----------- | ------- | ------------------------------------------------------------------------------------ |
| countryCode | string  | 2 letter country code (ISO-ALPHA-2)                                                  |
| language    | string  | 2 letter language code (ISO 639-1)                                                   |
| optOut      | boolean | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p> |
| aid         | string  | Mandatory in case of android application                                             |

{% tabs %}
{% tab title="200 Returned game example (This example displays one game result)" %}

```
{
mainDetails: {
gameId: 1029738,
sportTypeName: "Soccer",
leageName: "LaLiga",
season: "2016/2017",
status: "ENDED",
GT: "90'",
gameTime: "1492015500",
teams: [...],
scores: [...],
referee: "De Burgos Bengoetxea, Ricardo",
location: "Estadio Santiago Bernabéu (Madrid)"
},
matchDetails: {
whoWillWinResult: {
Vote1: "85313",
VoteX: "24417",
Vote2: "33792"
},
lineup: [...],
missingPlayers: [...],
events: [...]
}
}

```

{% endtab %}
{% endtabs %}

## Get Teams Data

<mark style="color:blue;">`GET`</mark> `https://sportapi.celltick.com/mediaApi/v1.0/sport/team/data`

The sport API will return teams data as requested.

#### Query Parameters

| Name        | Type    | Description                                                                          |
| ----------- | ------- | ------------------------------------------------------------------------------------ |
| 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 | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p> |
| aid         | string  | Mandatory in case of android application                                             |

{% tabs %}
{% tab title="200 " %}

```
{
popularSearches: [
"Manchester",
"Arsenal",
"Chelsea",
"Liverpool",
"Tottenham",
"Barca",
"Real",
"Juventus",
"Milan",
"Inter",
"Lakers",
"Federer",
"Nadal",
"Djokovic"
],
popularTeams: [
{
sportTypeId: 1,
SportTypeName: "Football",
SportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/1",
teamsList: […]
}
],
countriesList: […],
totalSelectedTeams: 3
}

```

{% endtab %}
{% endtabs %}

## Team Search

<mark style="color:blue;">`GET`</mark> `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

| Name        | Type    | Description                                                                                                                                                    |
| ----------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| sportType   | string  | Type of sport (e.g soccer)                                                                                                                                     |
| search      | string  | <p>Search string (can be part of team's name)<br>E.g. in case parameter is 'barcelo', all Barcelona teams from all different sport types will be returned.</p> |
| countryCode | string  | 2 letter country code (ISO-ALPHA-2)                                                                                                                            |
| language    | string  | 2 letter language code (ISO 639-1)                                                                                                                             |
| optOut      | boolean | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p>                                                                           |
| aid         | string  | Mandatory in case of android application                                                                                                                       |

{% tabs %}
{% tab title="200 Returned team search example" %}

```
{
teams: [
{
sportTypeId: 1,
teamsList: [...],
sportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/1",
sportTypeName: "Football"
},
{
sportTypeId: 2,
teamsList: [...],
sportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/2",
sportTypeName: "Basketball"
},
{
sportTypeId: 5,
teamsList: [...],
sportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/5",
sportTypeName: "Handball"
}
]
}

```

{% endtab %}
{% endtabs %}

## Get League

<mark style="color:blue;">`GET`</mark> `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

| Name        | Type    | Description                                                                          |
| ----------- | ------- | ------------------------------------------------------------------------------------ |
| 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 | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p> |
| aid         | string  | Mandatory in case of android application                                             |

{% tabs %}
{% tab title="200 Returned leagues example:" %}

```
{
leaguesList: [
{
leaguesList: […],
sportTypeId: 1,
sportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/1",
sportTypeName: "Football"
},
{
leaguesList: […],
sportTypeId: 2,
sportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/2",
sportTypeName: "Basketball"
}
],
leaguesShortList: [
{…},
{…},
{…}
]
}

```

{% endtab %}
{% endtabs %}

## Get League Teams

<mark style="color:blue;">`GET`</mark> `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

| Name | Type    | Description        |
| ---- | ------- | ------------------ |
| id   | integer | Specific league id |

#### Query Parameters

| Name        | Type    | Description                                                                          |
| ----------- | ------- | ------------------------------------------------------------------------------------ |
| countryCode | string  | 2 letter country code (ISO-ALPHA-2)                                                  |
| language    | string  | 2 letter language code (ISO 639-1)                                                   |
| optOut      | boolean | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p> |
| aid         | string  | Mandatory in case of android application                                             |

{% tabs %}
{% tab title="200 Returned team list for league example:" %}

```
{
totalTeams: 2,
teamsList: [
{
teamId: 168,
teamName: "Alaves",
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/168",
sportTypeId: 1,
sportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/1",
countryId: 2,
countryLogo: "http://res.cloudinary.com/start4cell/image/fetch/w_30,d_countries_default.png/http://res.cloudinary.com/scores365/image/upload/Countries/2",
selected: false
},
{
teamId: 144,
teamName: "Athletic Club",
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/144",
sportTypeId: 1,
sportTypeLogo: "http://res.cloudinary.com/start4cell/image/fetch/f_auto,fl_lossy,q_80,d_sportTypes_default.png/http://res.cloudinary.com/scores365/image/upload/SportTypes/1",
countryId: 2,
countryLogo: "http://res.cloudinary.com/start4cell/image/fetch/w_30,d_countries_default.png/http://res.cloudinary.com/scores365/image/upload/Countries/2",
selected: true
}
]
}

```

{% endtab %}
{% endtabs %}

## Follow Team

<mark style="color:blue;">`GET`</mark> `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

| Name   | Type    | Description           |
| ------ | ------- | --------------------- |
| teamId | integer | Specific team id      |
| userId | string  | Source user id (UUID) |

#### Query Parameters

| Name         | Type    | Description                                                                          |
| ------------ | ------- | ------------------------------------------------------------------------------------ |
| 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 | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p> |
| aid          | string  | Mandatory in case of android application                                             |

{% tabs %}
{% tab title="200 Returned user teams example:" %}

```
{
teams: {
132: {
country_id: 2
},
134: {
country_id: 2
},
144: {
country_id: 2
},
158: {
country_id: 2
}
},
country_id: -1,
language_id: 1,
timezone_id: 1,
language_code: "en"
}

```

{% endtab %}
{% endtabs %}

## Unfollow team

<mark style="color:blue;">`GET`</mark> `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

| Name   | Type    | Description           |
| ------ | ------- | --------------------- |
| teamId | integer | Specific team id      |
| userId | string  | Source user id (UUID) |

#### Query Parameters

| Name         | Type    | Description                                                                          |
| ------------ | ------- | ------------------------------------------------------------------------------------ |
| 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 | <p>Allowed values are:<br>true/false<br>Mandatory in case of android application</p> |
| aid          | string  | Mandatory in case of android application                                             |

{% tabs %}
{% tab title="200 Returned user teams example:" %}

```
{
134: {
country_id: 2
},
144: {
country_id: 2
},
158: {
country_id: 2
}
},
country_id: -1,
language_id: 1,
timezone_id: 1,
language_code: "en"
}

```

{% endtab %}
{% endtabs %}

## Get game list

<mark style="color:blue;">`GET`</mark> `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

| Name         | Type    | Description                                                                          |
| ------------ | ------- | ------------------------------------------------------------------------------------ |
| 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 | <p>Allowed values are:<br>true/false<br>Mandatory in case of Android application</p> |
| competitors  | string  | comma separated team ids                                                             |
| competitions | string  | comma separated competition ids (e.g league id)                                      |
| endDate      | string  | <p>Date format is MM/dd/yyyy<br>Default is 7 days ahead</p>                          |
| startDate    | string  | <p>Date format is MM/dd/yyyy<br>Default is 7 days back</p>                           |
| countryCode  | string  | 2 letter country code (ISO-ALPHA-2)                                                  |
| sportType    | string  | Supported types of sport (soccer, basketball)                                        |

{% tabs %}
{% tab title="200 " %}

```javascript
{
games: [
{
gameId: 1873772,
sportTypeName: "Cricket",
leageName: "Ranji Trophy",
stageNumber: 0,
status: "ENDED",
gameTime: "1492015500",
teams: [
{
teamId: 18597,
teamName: "Railways",
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/http://res.cloudinary.com/scores365/image/upload/Competitors/18597",
sportTypeId: 11,
countryId: 80,
isSelected: false,
},
{
teamId: 18593,
teamName: "Maharashtra",
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/http://res.cloudinary.com/scores365/image/upload/Competitors/18593",
sportTypeId: 11,
countryId: 80,
isSelected: false,
},
],
scores: [
{
teamId: 18597,
scr: 259,
},
{
teamId: 18593,
scr: 201,
},
],
attendance: 0,
whoWillWinResults: {
Vote1: "1",
VoteX: "1",
Vote2: "1",
},
}
```

{% endtab %}
{% endtabs %}

## Get cricket game list

<mark style="color:blue;">`GET`</mark> `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

| Name         | Type    | Description                                        |
| ------------ | ------- | -------------------------------------------------- |
| 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)    |

{% tabs %}
{% tab title="200 " %}

```
{
games: [
{
matchId: "190572",
matchFile: "newscw06272019190572",
startTime: "Jun 27, 2019 1:00:00 PM",
endTime: "Jun 27, 2019 5:00:00 PM",
status: "Future",
teams: [
{
id: 1123,
name: "Netherlands Women",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1123.png",
},
{
id: 1132,
name: "Scotland Women",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1132.png",
},
],
type: "T20",
stage: "League",
competition: "IWC",
matchNumber: "Match 4",
tour: {
id: 1096,
name: "ICC Women's World Twenty20 Europe Qualifier, 2019",
},
series: {
id: 3261,
name: "ICC Women's World Twenty20 Europe Qualifier, 2019",
},
venue: {
id: 1962,
name: "La Manga Club Bottom Ground, Cartagena, Murcia",
},
battingTeam: 0,
tossingTeam: 0,
winningTeam: 0,
gamePageURL: "https://qa.thestartmagazine.com/cricket/game/190572/?ref=TWFnYXppbmVfZnJvbV9TdGFydGVyJSQlWEU0bjNadDcyWEtQMWNpU3cxZ1pDNzd0OUdmMGJrT3AlJCUxMzU3OTg2NDI=&vendor=365scores&genericDimension=cricket",
isLive: false,
},
{
matchId: "186710",
matchFile: "wiin06272019186710",
startTime: "Jun 27, 2019 9:30:00 AM",
endTime: "Jun 27, 2019 5:30:00 PM",
status: "Future",
teams: [
{
id: 9,
name: "West Indies",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/9.png",
twitterId: "@windiescricket",
},
{
id: 4,
name: "India",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/4.png",
twitterId: "@BCCI",
},
],
type: "ODI",
stage: "Series",
competition: "CWC",
matchNumber: "Match 34",
tour: {
id: 898,
name: "ICC Cricket World Cup, 2019",
},
series: {
id: 2995,
name: "ICC Cricket World Cup, 2019",
},
venue: {
id: 117,
name: "Old Trafford, Manchester",
},
battingTeam: 0,
tossingTeam: 0,
winningTeam: 0,
gamePageURL: "https://qa.thestartmagazine.com/cricket/game/186710/?ref=TWFnYXppbmVfZnJvbV9TdGFydGVyJSQlWEU0bjNadDcyWEtQMWNpU3cxZ1pDNzd0OUdmMGJrT3AlJCUxMzU3OTg2NDI=&vendor=365scores&genericDimension=cricket",
isLive: false,
},
{
matchId: "190571",
matchFile: "newgew06272019190571",
startTime: "Jun 27, 2019 8:00:00 AM",
endTime: "Jun 27, 2019 12:00:00 PM",
status: "Future",
teams: [
{
id: 1123,
name: "Netherlands Women",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1123.png",
},
{
id: 1823,
name: "Germany Women",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1823.png",
},
],
type: "T20",
stage: "League",
competition: "IWC",
matchNumber: "Match 3",
tour: {
id: 1096,
name: "ICC Women's World Twenty20 Europe Qualifier, 2019",
},
series: {
id: 3261,
name: "ICC Women's World Twenty20 Europe Qualifier, 2019",
},
venue: {
id: 1962,
name: "La Manga Club Bottom Ground, Cartagena, Murcia",
},
battingTeam: 0,
tossingTeam: 0,
winningTeam: 0,
gamePageURL: "https://qa.thestartmagazine.com/cricket/game/190571/?ref=TWFnYXppbmVfZnJvbV9TdGFydGVyJSQlWEU0bjNadDcyWEtQMWNpU3cxZ1pDNzd0OUdmMGJrT3AlJCUxMzU3OTg2NDI=&vendor=365scores&genericDimension=cricket",
isLive: false,
},
{
matchId: "190570",
matchFile: "scwnew06262019190570",
startTime: "Jun 26, 2019 1:00:00 PM",
endTime: "Jun 26, 2019 5:00:00 PM",
status: "Future",
teams: [
{
id: 1132,
name: "Scotland Women",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1132.png",
},
{
id: 1123,
name: "Netherlands Women",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1123.png",
},
],
type: "T20",
stage: "League",
competition: "IWC",
matchNumber: "Match 2",
tour: {
id: 1096,
name: "ICC Women's World Twenty20 Europe Qualifier, 2019",
},
series: {
id: 3261,
name: "ICC Women's World Twenty20 Europe Qualifier, 2019",
},
venue: {
id: 1962,
name: "La Manga Club Bottom Ground, Cartagena, Murcia",
},
battingTeam: 0,
tossingTeam: 0,
winningTeam: 0,
gamePageURL: "https://qa.thestartmagazine.com/cricket/game/190570/?ref=TWFnYXppbmVfZnJvbV9TdGFydGVyJSQlWEU0bjNadDcyWEtQMWNpU3cxZ1pDNzd0OUdmMGJrT3AlJCUxMzU3OTg2NDI=&vendor=365scores&genericDimension=cricket",
isLive: false,
},
{
matchId: "186709",
matchFile: "nzpk06262019186709",
startTime: "Jun 26, 2019 9:30:00 AM",
endTime: "Jun 26, 2019 5:30:00 PM",
status: "Future",
teams: [
{
id: 5,
name: "New Zealand",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/5.png",
twitterId: "@BLACKCAPS",
},
{
id: 6,
name: "Pakistan",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/6.png",
twitterId: "@TheRealPCB",
},
],
type: "ODI",
stage: "Series",
competition: "CWC",
matchNumber: "Match 33",
tour: {
id: 898,
name: "ICC Cricket World Cup, 2019",
},
series: {
id: 2995,
name: "ICC Cricket World Cup, 2019",
},
venue: {
id: 50,
name: "Edgbaston, Birmingham",
},
battingTeam: 0,
tossingTeam: 0,
winningTeam: 0,
gamePageURL: "https://qa.thestartmagazine.com/cricket/game/186709/?ref=TWFnYXppbmVfZnJvbV9TdGFydGVyJSQlWEU0bjNadDcyWEtQMWNpU3cxZ1pDNzd0OUdmMGJrT3AlJCUxMzU3OTg2NDI=&vendor=365scores&genericDimension=cricket",
isLive: false,
},
]
}
```

{% endtab %}
{% endtabs %}

## Get specific cricket game

<mark style="color:blue;">`GET`</mark> `https://sportapi.celltick.com/mediaApi/v1.0/sport/cricket/{id}`

Method returns specific cricket game data. Response is in English.

#### Path Parameters

| Name | Type    | Description     |
| ---- | ------- | --------------- |
| id   | integer | cricket game id |

#### Query Parameters

| Name   | Type    | Description                              |
| ------ | ------- | ---------------------------------------- |
| optOut | boolean | Mandatory in case of Android application |
| aid    | string  | Mandatory in case of Android application |

{% tabs %}
{% tab title="200 " %}

```
{
matchId: "188148",
matchFile: "cchl04262019188148",
startTime: "Apr 26, 2019 4:00:00 PM",
endTime: "Apr 26, 2019 8:00:00 PM",
status: "Ended",
result: "Highveld Lions beat Cape Cobras by 6 wickets",
winMargin: "6 wickets",
tossElected: "field",
teams: [
{
id: 1142,
name: "Cape Cobras",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1142.png",
twitterId: "@CobrasCricket",
},
{
id: 1195,
name: "Highveld Lions",
logoURL: "https://imageca.thestartmagazine.com/upload/cricket/1195.png",
twitterId: "@LionsCricketSA",
},
],
scores: [
{
teamId: 1142,
score: "133/7 (20.0 ov)",
},
{
teamId: 1195,
score: "134/4 (15.5 ov)",
},
],
type: "T20",
stage: "League",
competition: "CSA",
matchNumber: "Match 25",
tour: {
id: 979,
name: "CSA T20 Challenge, 2019",
},
series: {
id: 3105,
name: "CSA T20 Challenge, 2019",
},
venue: {
id: 112,
name: "Newlands, Cape Town",
},
battingTeam: 0,
tossingTeam: 1195,
winningTeam: 1195,
gamePageURL: "https://qa.thestartmagazine.com/cricket/game/188148/?ref=TWFnYXppbmVfZnJvbV9TdGFydGVyJSQlWEU0bjNadDcyWEtQMWNpU3cxZ1pDNzd0OUdmMGJrT3AlJCUxMzU3OTg2NDI=&vendor=365scores&genericDimension=cricket",
isLive: false,
}
```

{% endtab %}
{% endtabs %}

## Get Player

<mark style="color:blue;">`GET`</mark> `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

| Name | Type    | Description |
| ---- | ------- | ----------- |
| id   | integer | Player id   |

#### Query Parameters

| Name          | Type   | Description                               |
| ------------- | ------ | ----------------------------------------- |
| 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) |

{% tabs %}
{% tab title="200 " %}

```
{
name: "Duvan Zapata",
birthdate: "01-04-1991",
age: "28",
height: "1.86",
weight: "80 kg",
teamName: "Atalanta",
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/http://res.cloudinary.com/scores365/image/upload/Competitors/232",
competitionName: "Copa Oro",
Stats: [
{
T: 1,
type: "Goles",
V: "23",
},
{
T: 2,
type: "Asistencias",
V: "7",
},
{
T: 3,
type: "Tarjetas Amarillas",
V: "5",
},
{
T: 4,
type: "Tarjetas Rojas",
V: "0",
},
{
T: 5,
type: "Apariciones",
V: "37",
},
{
T: 6,
type: "Formación",
V: "32",
},
{
T: 7,
type: "Sustituciones",
V: "5",
},
{
T: 8,
type: "Tiempo Jugado",
V: "2898",
},
{
T: 9,
type: "Minutos Por Gol",
V: "126",
},
],
}
```

{% endtab %}
{% endtabs %}

## Get team roster

<mark style="color:blue;">`GET`</mark> `https://sportapi.celltick.com/mediaApi/v1.0/sport/team/roster`

Method returns roster for team and player's statistics for selected competition

#### Query Parameters

| Name          | Type    | Description                              |
| ------------- | ------- | ---------------------------------------- |
| 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                           |

{% tabs %}
{% tab title="200 " %}

```
{
teamName: "Mexico",
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/http://res.cloudinary.com/scores365/image/upload/Competitors/5106",
competitionName: "Gold Cup",
playerStatistics: [
{
name: "Guillermo Ochoa",
birthdate: "13-07-1985",
age: "33",
height: "1.85",
weight: "78 kg",
Stats: [
{
T: 1,
type: "Goals",
V: "0",
},
{
T: 2,
type: "Assists",
V: "1",
},
{
T: 3,
type: "Yellow Cards",
V: "0",
},
{
T: 4,
type: "Red Cards",
V: "0",
},
{
T: 5,
type: "Appearances",
V: "40",
},
{
T: 6,
type: "Lineups",
V: "40",
},
{
T: 7,
type: "Substitutions",
V: "0",
},
{
T: 8,
type: "Time Played",
V: "3600",
},
{
T: 9,
type: "Minutes Per Goal",
V: "0",
},
],
},
{
name: "Andres Guardado",
birthdate: "08-09-1986",
age: "32",
height: "1.69",
weight: "60 kg",
Stats: [
{
T: 1,
type: "Goals",
V: "0",
},
.
.
.
.
```

{% endtab %}
{% endtabs %}

## Get competition standing table

<mark style="color:blue;">`GET`</mark> `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

| Name          | Type    | Description                            |
| ------------- | ------- | -------------------------------------- |
| competitionId | integer | competition id (e.g. 595 Copa America) |

#### Query Parameters

| Name        | Type   | Description                              |
| ----------- | ------ | ---------------------------------------- |
| 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)       |

{% tabs %}
{% tab title="200 " %}

```
{
competition: {
Name: "Copa America",
season: "2019",
stage: "Group Stage",
tableRows: [
{
Competitor: {
ID: 2379,
Name: "Brazil",
CID: 21,
SID: 1,
teamLogo: "https://imageca.thestartmagazine.com/upload/365/flags/2379.png",
},
Position: 1,
GamePlayed: 0,
GamesWon: 0,
GamesLost: 0,
GamesEven: 0,
For: 0,
Against: 0,
Points: 0,
Group: 1,
Goals: "0:0",
GroupName: "Group A",
},
{
Competitor: {
ID: 5076,
Name: "Peru",
CID: 112,
SID: 1,
teamLogo: "https://imageca.thestartmagazine.com/upload/365/flags/5076.png",
},
Position: 2,
GamePlayed: 0,
GamesWon: 0,
GamesLost: 0,
GamesEven: 0,
For: 0,
Against: 0,
Points: 0,
Group: 1,
Goals: "0:0",
GroupName: "Group A",
},
{
Competitor: {
ID: 5072,
Name: "Venezuela",
.
.
.
.
```

{% endtab %}
{% endtabs %}

## Get Game votes (who will win)

<mark style="color:blue;">`GET`</mark> `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

| Name        | Type    | Description                                  |
| ----------- | ------- | -------------------------------------------- |
| 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)           |

{% tabs %}
{% tab title="200 " %}

```
[
{
mainDetails: {
gameId: 2005085,
sportTypeName: "Basketball",
leageName: "Lega A",
season: "2018/2019",
stage: "Semi Final",
stageNumber: 3,
status: "FUTURE",
playingStatus: 0,
countDown: 41980,
gameTime: "1492015500",
teams: [],
gameScores: [],
location: "Palasport Taliercio",
attendance: 0,
whoWillWinResults: {
Vote1: "79",
VoteX: "1",
Vote2: "47",
},
seriesScore: [
1,
2,
],
round: 4,
},
matchDetails: {
whoWillWinResult: {
Vote1: "79",
VoteX: "1",
Vote2: "47",
}
},
}
]
```

{% endtab %}
{% endtabs %}

## Get competition votes (who will win)

<mark style="color:blue;">`GET`</mark> `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

| Name          | Type    | Description    |
| ------------- | ------- | -------------- |
| competitionId | integer | competition id |

#### Query Parameters

| Name        | Type    | Description                                  |
| ----------- | ------- | -------------------------------------------- |
| 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)           |

{% tabs %}
{% tab title="200 " %}

```
[
{
mainDetails: {
gameId: 2005085,
sportTypeName: "Basketball",
leageName: "Lega A",
season: "2018/2019",
stage: "Semi Final",
stageNumber: 3,
status: "FUTURE",
playingStatus: 0,
countDown: 41980,
gameTime: "1492015500",
teams: [],
gameScores: [],
location: "Palasport Taliercio",
attendance: 0,
whoWillWinResults: {
Vote1: "79",
VoteX: "1",
Vote2: "47",
},
seriesScore: [
1,
2,
],
round: 4,
},
matchDetails: {
whoWillWinResult: {
Vote1: "79",
VoteX: "1",
Vote2: "47",
}
},
}
]
```

{% endtab %}
{% endtabs %}

## Get team statistics

<mark style="color:blue;">`GET`</mark> `https://sportapi.celltick.com/mediaApi/v1.0/sport/team/{id}/stats`

Method returns team statistics in specific competition

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
| id   | string | team id     |

#### Query Parameters

| Name          | Type    | Description           |
| ------------- | ------- | --------------------- |
| competitionId | integer | competition id        |
| countryCode   | string  | 2 letter country code |
| language      | string  | 2 letter language     |

{% tabs %}
{% tab title="200 " %}

```
{
Competitor: {
ID: 5106,
Name: "Mexico",
CID: 31,
SID: 1,
teamLogo: "https://imageca.thestartmagazine.com/upload/365/flags/5106.png",
},
Position: 2,
GamePlayed: 0,
GamesWon: 0,
GamesLost: 0,
GamesEven: 0,
For: 0,
Against: 0,
Points: 0,
Group: 1,
Goals: "0:0",
GroupName: "Group A",
}
```

{% endtab %}
{% endtabs %}

## Get popular teams

<mark style="color:blue;">`GET`</mark> `https://sportapi.celltick.com/mediaApi/v1.0/sport/team/popular`

Method returns list of popular teams for sport type and country.

#### Query Parameters

| Name        | Type    | Description               |
| ----------- | ------- | ------------------------- |
| limit       | integer | number of teams to return |
| sportType   | string  | soccer or basket ball     |
| countryCode | string  | 2 letter country code     |
| language    | string  | 2 letter language         |

{% tabs %}
{% tab title="200 " %}

```
{
totalTeams: 10,
teamsList: [
{
id: 1255,
name: "Club América",
wikiId: "Q459090",
sportId: 1,
countryId: 31,
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/https://res.cloudinary.com/scores365/image/upload/Competitors/1255",
},
{
id: 1259,
name: "Chivas de Guadalajara",
wikiId: "Q503321",
sportId: 1,
countryId: 31,
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/https://res.cloudinary.com/scores365/image/upload/Competitors/1259",
},
{
id: 132,
name: "FC Barcelona",
wikiId: "Q7156",
sportId: 1,
countryId: 2,
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/https://res.cloudinary.com/scores365/image/upload/Competitors/132",
},
{
id: 1261,
name: "Cruz Azul",
wikiId: "Q845859",
sportId: 1,
countryId: 31,
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/https://res.cloudinary.com/scores365/image/upload/Competitors/1261",
},
{
id: 131,
name: "Real Madrid",
wikiId: "Q8682",
sportId: 1,
countryId: 2,
teamLogo: "https://imageca.thestartmagazine.com/fetch/fl_lossy,w_100,h_100,q_70,d_competitors_default1.png/https://res.cloudinary.com/scores365/image/upload/Competitors/131",
},
.
.
.
.
```

{% endtab %}
{% endtabs %}

## Get competition teams

<mark style="color:blue;">`GET`</mark> `https://sportapi.celltick.com/mediaApi/v1.0/sport/competition/{competitionId}/teams`

Method return list of team for specific competition

#### Path Parameters

| Name          | Type    | Description    |
| ------------- | ------- | -------------- |
| competitionId | integer | competition id |

#### Query Parameters

| Name        | Type   | Description            |
| ----------- | ------ | ---------------------- |
| countryCode | string | 2 letter country code  |
| language    | string | 2 letter language code |

{% tabs %}
{% tab title="200 " %}

```
{
totalTeams: 12,
teamsList: [
{
teamId: 2378,
teamName: "Argentina",
teamSymbolicName: null,
teamLogo: "https://imageca.thestartmagazine.com/upload/365/flags/2378.png",
teamLogoShort: "https://imageca.thestartmagazine.com/upload/365/flags/2378.png",
sportTypeId: null,
sportTypeLogo: null,
countryId: 10,
countryCode: "AR",
countryLogo: null,
position: 0,
wins: 0,
losses: 0,
twitterId: null,
selected: false,
color: null,
color2: null,
awayColor: null,
awayColor2: null,
},
{
teamId: 5077,
teamName: "Bolivia",
teamSymbolicName: null,
teamLogo: "https://imageca.thestartmagazine.com/upload/365/flags/5077.png",
teamLogoShort: "https://imageca.thestartmagazine.com/upload/365/flags/5077.png",
sportTypeId: null,
sportTypeLogo: null,
countryId: 113,
countryCode: "BO",
countryLogo: null,
position: 0,
wins: 0,
losses: 0,
twitterId: null,
selected: false,
color: null,
color2: null,
awayColor: null,
awayColor2: null,
},
{
.
.
.
.
```

{% endtab %}
{% endtabs %}
