Content API
Request for content is done using the HTTPS API, The response is a JSON object.
Transport protocol
The Celltick Content API is implemented as a Restful protocol using stateless HTTPS transactions. Requests are sent using the GET HTTPS method and responses are formatted as a JSON formatted string.
Get Categories
GET https://contentapi.celltick.com/mediaApi/mediaApi/v1.0/category
Method return list of content categories
Query Parameters
vendorFilter
string
filtered out content providers (comma separated names)
vendor
string
specific content provider (comma separated names)
categoryFilter
string
Allows to filter out categories by name (comma separated list, e.g. Sports,News)
tag
string
comma separated tag names (e.g. ball,goal)
media
string
Is used in case the request is for video categories
aid
string
Mandatory In case of android application.
optOut
string
Allowed values are: true/false Mandatory In case of android application.
localCountryCode
string
Allows fetching categories by local country,2 letter country code (ISO-ALPHA-2)
originCountryCode
string
Allows fetching categories by origin country, 2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
countryCode
string
Allows fetching categories by country, 2 letter country code (ISO-ALPHA-2)
userId
string
Source user ID
{
"categories": [
{
"categoryId": 7,
"categoryName": "Sports",
"translatedName": "Sports",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Sports01.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539086065/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE980VH:1.jpg"
},
{
"categoryId": 4,
"categoryName": "World news",
"translatedName": "World news",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_World%20news02.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539083961/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE980SD:1.jpg"
},
{
"categoryId": 13,
"categoryName": "News",
"translatedName": "News",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_News03.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1538980051/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE970AU:1.jpg"
},
{
"categoryId": 12,
"categoryName": "Entertainment",
"translatedName": "Entertainment",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Entertainment04.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fvcdn-giaitri.vnecdn.net%2F2018%2F10%2F09%2FA1-6689-1539081589.jpg"
},
{
"categoryId": 48,
"categoryName": "Finance",
"translatedName": "Finance",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Finance05.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539068120/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE9803O:1.jpg"
},
{
"categoryId": 42,
"categoryName": "Lifestyle",
"translatedName": "Lifestyle",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Lifestyle06.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1538931451/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE960YY:2.jpg"
},
{
"categoryId": 65,
"categoryName": "Music",
"translatedName": "Music",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Music07.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539067767/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE970RT:1.jpg"
},
{
"categoryId": 17,
"categoryName": "Celebrities",
"translatedName": "Celebrities",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Celebrities08.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539067767/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE970RT:1.jpg"
},
{
"categoryId": 9,
"categoryName": "Technology",
"translatedName": "Technology",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Technology09.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539067190/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE970XQ:1.jpg"
},
{
"categoryId": 8,
"categoryName": "Movies",
"translatedName": "Movies",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Movies10.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fc.ndtvimg.com%2F2018-10%2F2cgvcs08_alok-nath-vinta-nanda_625x300_09_October_18.jpg"
},
{
"categoryId": 24,
"categoryName": "Health",
"translatedName": "Health",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Health01.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fvcdn-suckhoe.vnecdn.net%2F2018%2F10%2F08%2F43328100-470010683509432-18626-3167-2386-1538983549.jpg"
},
{
"categoryId": 18,
"categoryName": "Fashion",
"translatedName": "Fashion",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Fashion02.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fss-images.catscdn.vn%2Fw750%2F2018%2F10%2F09%2F3831308%2Fkhamyvan-vungocson1.jpg"
},
{
"categoryId": 83,
"categoryName": "Environment",
"translatedName": "Environment",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Environment03.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539083961/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE980SD:1.jpg"
},
{
"categoryId": 16,
"categoryName": "Beauty",
"translatedName": "Beauty",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Beauty04.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fvcdn-ngoisao.vnecdn.net%2F2018%2F10%2F09%2F1-copy-1792-1539075183.jpg"
},
{
"categoryId": 75,
"categoryName": "Television",
"translatedName": "Television",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Television05.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fss-images.catscdn.vn%2Fw750%2F2018%2F10%2F08%2F3822504%2F41591099_1631522026954334_4783637784549529298_n.jpg"
},
{
"categoryId": 85,
"categoryName": "Tourism",
"translatedName": "Tourism",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Tourism06.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fcdn.cnn.com%2Fcnnnext%2Fdam%2Fassets%2F181008131010-sand-scultpure-tz-1-video-synd-2.jpg"
},
{
"categoryId": 91,
"categoryName": "Mergers",
"translatedName": "Mergers",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Mergers07.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539082467/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE980PK:1.jpg"
},
{
"categoryId": 46,
"categoryName": "Culture",
"translatedName": "Culture",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Culture08.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fc.files.bbci.co.uk%2F75E1%2Fproduction%2F_103777103_gettyimages-462139028.jpg"
},
{
"categoryId": 45,
"categoryName": "Trends",
"translatedName": "Trends",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Trends09.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fimages.desimartini.com%2Fmedia%2Fuploads%2F2018-5%2Fthumbnail_y0TXDHN.jpg"
},
{
"categoryId": 14,
"categoryName": "Science",
"translatedName": "Science",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Science10.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fvcdn-vnexpress.vnecdn.net%2F2018%2F10%2F09%2FVNE-Boeing-1-5579-1539071423.jpg"
},
{
"categoryId": 19,
"categoryName": "Game News",
"translatedName": "Game News",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Game%20News01.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http%3A%2F%2Fa.espncdn.com%2Fphoto%2F2018%2F1006%2Fr442842_1276x718_16-9.jpg"
},
{
"categoryId": 77,
"categoryName": "Food",
"translatedName": "Food",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Food02.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https%3A%2F%2Fi.ndtvimg.com%2Fi%2F2018-01%2Fboti-kebab_620x350_71516706311.jpg"
},
{
"categoryId": 39,
"categoryName": "Tennis",
"translatedName": "Tennis",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Tennis03.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/https://www.atpworldtour.com/-/media/images/news/2018/10/08/09/24/bautista-agut-shanghai-2018-monday.jpg%3Fla=en&hash=1C8F5B51A56616C216251C21B6B4B758BF2A918A"
}
],
"totalItems": 23
}Get Category By ID
GET https://contentapi.celltick.com/mediaApi/mediaApi/v1.0/category/id/{categoryId}
Method returns single category.
Path Parameters
categoryId
string
The specific category Id
Query Parameters
userId
string
Source user id (UUID).
optOut
string
Allowed values are: true/false Mandatory In case of android application.
aid
string
Mandatory In case of android application.
{
"totalItems": 1,
"categories": [
{
"categoryId": 7,
"categoryName": "Sports",
"translatedName": "Sports",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Sports01.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539067164/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE9807Q:1.jpg"
}
]
}Get Category By Name
GET https://contentapi.celltick.com/mediaApi/v1.0/category/name/{categoryName}
Returns single category item by its name (in English)
Path Parameters
categoryName
string
The specific category name (English)
Query Parameters
optOut
string
Allowed values are: true/false Mandatory In case of android application.
aid
string
Mandatory In case of android application.
userId
string
Source user id (UUID)
{
"totalItems": 1,
"categories": [
{
"categoryId": 7,
"categoryName": "Sports",
"translatedName": "Sports",
"imageUrl": "https://imageca.thestartmagazine.com/fetch/d_m_Sports01.jpg,c_fill,g_auto,fl_lossy,q_30,r_max,w_60,h_60/http://res.cloudinary.com/start4cell/image/upload/v1539067164/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE9807Q:1.jpg"
}
]
}Get Content List
GET https://contentapi.celltick.com/mediaApi/v1.0/content/
Query Parameters
vendorFilter
string
filtered out comma separated content provider names
vendor
string
comma separated content provider names
topic
string
list of comma separated topic names or Wikipedia ids. In case extended search needed please add :ext to topic name. (e.g. weather:ext)
team
string
list of comma separated sport team names or Wikipedia ids
person
string
list of comma separated person names or Wikipedia ids
sortBy
string
Parameter used to allow content sort by “newest” articles first (in descending order). In case parameter not in use, content order define by System.
thumbImgQuality
integer
Set thumbnail image quality (e.g. 30 is 30% of the original quality )
thumbImgWidth
integer
Set thumbnail image width (pixels)
thumbImgHeight
integer
Set thumbnail image height (pixels)
limit
integer
Limits the number of returned content items. Default is 20.
offset
integer
For paging only. When offset=0 returns all query content items.
language
string
2 letter language code (ISO 639-1)
localCountryCode
string
String Allows fetching categories by local country 2 letter country code (ISO-ALPHA-2)
originCountryCode
string
Allows fetching categories by origin country 2 letter country code (ISO-ALPHA-2)
countryCode
string
Allows fetching content by country.2 letter country code (ISO-ALPHA-2)
tag
string
Allows fetching content by tag names (case insensitive) [one or more]
categoryFilter
string
Allow filter out content by category names [one or more] (e.g. categoryFilter=Sports,News)
category
string
Allows fetching content by specific category names [one or more] (e.g. category=Sports,News) (Case insensitive)
publishedAfter
string
Allows fetching content from point in time and on. Date/time of publication format is: “MM/dd/yyyy hh:mm:ss”
optOut
boolean
Allowed values are: true/false, Mandatory In case of android application
aid
string
Mandatory In case of android application
userId
string
String Source user id (UUID)
{
"totalItems": 1,
"content": [
{
"contentId": "1303167c-250b-4f17-af1c-86aaee127e49",
"title": "Bolt may start in Central Coast trial match",
"summary": "Central Coast coach Mike Mulvey said he's considering starting Usain Bolt in a trial against a Macarthur South West United team on Friday.",
"contentSource": "ESPN_INDIA",
"contentSourceDisplay": "ESPN INDIA",
"categories": [
"Sports"
],
"categoriesEnglish": [
"Sports"
],
"images": {
"mainImage": {
"url": "https://imageca.thestartmagazine.com/fetch/d_m_Sports12.jpg,c_fill,g_auto,fl_lossy,q_30,w_480/http://a3.espncdn.com/combiner/i%3Fimg=%2Fphoto%2F2018%2F0831%2Fr423842_1296x729_16%2D9.jpg",
"width": 1296,
"height": 729
},
"mainImageThumbnail": {
"url": "https://imageca.thestartmagazine.com/fetch/d_m_Sports12.jpg,c_fill,g_auto,fl_lossy,q_30,w_270,h_190/http://a3.espncdn.com/combiner/i%3Fimg=%2Fphoto%2F2018%2F0831%2Fr423842_1296x729_16%2D9.jpg",
"width": 270,
"height": 190,
"quality": 30
},
"additionalImages": []
},
"countries": [
"IN"
],
"locale": "en_IN",
"publishedAt": 1539122417,
"tags": [
"football",
"epin_en-sports",
"epsocmag"
],
"views": 104,
"isPreview": false,
"contentURL": "https://www.thestartmagazine.com/article/1303167c-250b-4f17-af1c-86aaee127e49?ref=TWFnYXppbmUtVGVzdCUkJXgwOE85U3ljZDE3TlI3MXkxOTNTdUk2WTU1cDZzYzR1JSQlMTM1Nzk4NjQy&category=7&countryCode=IN&language=en&vendorFilter=Livescreen&recommendationId=TIME_BL",
"recommendationId": "TIME_BL"
}
]
}Get Content By Id
GET https://contentapi.celltick.com/mediaApi/v1.0/content/{contentId}
Path Parameters
contentId
string
UUID format
Query Parameters
optOut
string
Allowed values are: true/false. Mandatory In case of android application.
aid
string
Mandatory In case of android application.
userId
string
Source user id (UUID).
{
"totalItems": 1,
"content": [
{
"contentId": "91c7205e-8b6f-4912-b270-6523bc7d6e44",
"title": "With no true identity yet, Emery has Arsenal on proper path",
"summary": "Unai Emery is not particularly renowned for his football philosophy, but he has Arsenal winning despite some growing pains and fractured results.",
"contentSource": "ESPN_INDIA",
"contentSourceDisplay": "ESPN INDIA",
"categories": [
"Sports"
],
"categoriesEnglish": [
"Sports"
],
"text": "<p>After eight games of the Premier League season, Arsenal find themselves only two points off the top. It's a remarkable record for a side still in transition under new boss Unai Emery, but it's somewhat difficult to explain precisely how they've strung together six consecutive league victories, considering their fractured performances thus far.</p><p>Emery is an interesting coach: neither a defensive or an attacking manager, not particularly renowned for one specific footballing concept. Summaries of Emery's approach tend to focus upon his attention-to-detail rather than his overall footballing philosophy, and it feels odd that Arsenal, the grand philosophers of the Premier League over the past two decades, are not attempting to perfect a particularly specific approach.</p><p>Arguably the two most obvious consequences of Emery's coaching have been simple: playing out from the back, and pressing from the front. Neither are revolutionary concepts, merely standard features of top-level modern sides, and neither have proved entirely effective thus far. Petr Cech has encountered problems when attempting to pass his way out of trouble, managing to concede corners on two occasions when badly miscuing passes. Bernd Leno may prove more reliable, but the German has only become a regular in Cech's absence, when Emery might have been expected to prefer him from the outset, making a statement about his priorities.</p><p>There has, in fairness, been one major positive from the commitment to playing out -- their equaliser in the 3-2 defeat at Stamford Bridge, which featured ten Arsenal players stringing together passes before Alex Iwobi finished calmly from close-range. That move, coming in Arsenal's second game, will doubtless have been referenced several times by Emery, who has introduced more video sessions than Arsenal's players were accustomed to.</p><p>Arsenal's pressing has been considerably less effective. Their attackers have been bypassed far too readily when attempting to pressure the opposition in their own half, and while there's no particular shame in that happening against Manchester City, Marco Silva's Everton managed it fairly easily too.</p><p>These attempts at pressing are causing problems in deeper positions. Neither Sokratis Papastathopoulos nor Shkodran Mustafi look comfortable in a high defensive line, although the former did demonstrate a handy turn of speed to get the latter out of trouble in the 2-1 win away at Newcastle. Still, the likes of Chelsea and Watford have broken in behind too readily.</p><p>The centre-backs have also found themselves covering too much ground in wide areas, because Emery has allowed both Hector Bellerin and Nacho Monreal to push forward simultaneously. There have been some positive benefits here: Monreal scored Arsenal's equaliser in the 3-1 victory over West Ham from a deflected Bellerin cross, and the latter's constant overlapping has been a crucial feature of the Gunners' attacking play.</p><p>Both full-backs pushing forward has nevertheless felt too risky, and it's surprising Arsenal haven't been caught out more from counter-attacks. West Ham should have punished them in those situations, particularly through Felipe Anderson, while the Gunners were fortunate that Isaac Success dinked against the far post on the break in Arsenal's eventual 2-0 win over Watford.</p><p>Some protection has been provided by Arsenal's central midfielders, and it's notable that Emery has refused to use Aaron Ramsey in one of the two deeper midfield roles, his most common position when Arsenal used 4-2-3-1 under Wenger. Instead, it's been two of Matteo Guendouzi, Granit Xhaka and Lucas Torreira, with the latter two most likely to continue as regulars. It's Arsenal's feistiest combination for years, and supporters love a committed tackler, but both need more positional discipline and a little less impetuousness.</p>play<h1>Premier League Team of the Weekend: Week 8</h1><p>Steve Nicol reveals his best XI from the eighth round of Premier League action, which leaves Gab Marcotti asking questions.</p><p>Going forward, Emery has changed course. In the first three games of the campaign he started Pierre-Emerick Aubameyang upfront, with Alexandre Lacazette only on the bench. But after the Frenchman made a good impact as a substitute against Manchester City and, in particular, the 3-1 win over West Ham, he's started upfront with Aubameyang playing from the left. Their combination play has sometimes worked excellently, including for Aubameyang's lovely curling strike against Cardiff after Lacazette's clever touch. Their relationship is excellent -- even when Aubameyang was rested for the weekend victory over Fulham, Lacazette rushed over to celebrate his opener with him.</p><p>Again, though, that has compromised Arsenal's balance. Monreal has been protected better when Alex Iwobi has been fielded down that flank, and Aubameyang's determination to become a second striker has contributed to the openness at turnovers.</p><p>Perhaps the strangest thing about Arsenal is that Aaron Ramsey has been fielded as the number 10 in six of Arsenal's eight Premier League matches, and rounded off arguably the best goal of the Premier League season in Sunday's 5-1 win at Fulham, but he appears likely to leave the club next summer because of contractual issues. Emery will therefore be dissuaded from building the attack around him, which would probably mean Ozil returning to his favoured role -- where he's only started once this season, away at Chelsea, when he was substituted midway through the second half, for Ramsey.</p><p>And therefore, despite the six league victories in a row -- nine in all competitions -- it's difficult to assess one area that looks right under Emery.</p><p>At a push, Arsenal have prospered so far because they've excelled in the penalty boxes. Upfront, Lacazette and Aubemeyang have managed four league goals apiece, but Arsenal's Premier goals have been shared around by ten players, which becomes 13 when you consider the Europa League. At the back, Cech provided a man-of-the-match performance in the win over Everton, and Leno made some fine saves as a substitute against Watford.</p><p>It might sound harsh on a manager who has recorded nine victories from 11 matches in a new country, but it's difficult to give Emery too much praise for these features. Arsenal have been impressive in terms of individual contributions at either end, but there remain major questions about the format of the attack, the structure of the midfield and the positioning of the defence. Maybe Arsenal will improve further when Emery fixes structural problems, maybe Emery's coaching of individuals has improved their finishing. But thus far Arsenal have conceded too many chances, and depended upon shooting quality which might not prove sustainable.</p><p>By now, we might have expected Emery's Arsenal to be decisively continuing along a particular tactical course but struggling to convert their intentions into points. Instead it's the opposite: Arsenal are collecting points despite muddled intentions. Emery, you suspect, knows that better than anyone.</p> ",
"origURL": "http://www.espn.in/football/club/arsenal/359/blog/post/3665282/arsenal-are-still-a-work-in-progressbut-unai-emery-is-getting-results?ex_cid=startmag",
"images": {
"mainImage": {
"url": "https://imageca.thestartmagazine.com/fetch/d_m_Sports20.jpg,c_fill,g_auto,fl_lossy,q_30,w_480/http://a3.espncdn.com/combiner/i%3Fimg=%2Fphoto%2F2018%2F1009%2Fr444477_1296x729_16%2D9.jpg",
"width": 1296,
"height": 729
},
"mainImageThumbnail": {
"url": "https://imageca.thestartmagazine.com/fetch/d_m_Sports20.jpg,c_fill,g_auto,fl_lossy,q_30,w_270,h_190/http://a3.espncdn.com/combiner/i%3Fimg=%2Fphoto%2F2018%2F1009%2Fr444477_1296x729_16%2D9.jpg",
"width": 270,
"height": 190,
"quality": 30
},
"additionalImages": []
},
"countries": [
"IN"
],
"locale": "en_IN",
"publishedAt": 1539174506,
"tags": [
"football",
"epin_en-sports",
"epsocmag"
],
"views": 1299,
"isPreview": false,
"relatedArticles": [
{
"contentId": "0c663618-e9b3-4241-ab82-e4323cbf3262",
"title": "Soccer: Arsenal run riot in second half to win 5-1 at Fulham",
"contentURL": "https://www.thestartmagazine.com/article/0c663618-e9b3-4241-ab82-e4323cbf3262?ref=TWFnYXppbmUtVGVzdCUkJXgwOE85U3ljZDE3TlI3MXkxOTNTdUk2WTU1cDZzYzR1JSQlMTM1Nzk4NjQy&relatedRecommenderId=topic",
"imageURL": "https://imageca.thestartmagazine.com/fetch/d_m_Sports50.jpg,c_fill,g_auto,fl_lossy,q_80/http://res.cloudinary.com/start4cell/image/upload/v1538919152/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE960RS:1.jpg",
"publishedAt": 1538920150,
"contentSource": "Reuters",
"categoryName": "Sports",
"categoryId": 7
},
{
"contentId": "2fc76a07-2fa5-4b05-9316-e5180e135d6b",
"title": "Soccer: Ramsey wonder goal reminds Arsenal what they would miss",
"contentURL": "https://www.thestartmagazine.com/article/2fc76a07-2fa5-4b05-9316-e5180e135d6b?ref=TWFnYXppbmUtVGVzdCUkJXgwOE85U3ljZDE3TlI3MXkxOTNTdUk2WTU1cDZzYzR1JSQlMTM1Nzk4NjQy&relatedRecommenderId=topic",
"imageURL": "https://imageca.thestartmagazine.com/fetch/d_m_Sports04.jpg,c_fill,g_auto,fl_lossy,q_80/http://res.cloudinary.com/start4cell/image/upload/v1538922752/reuters_tag:reuters.com%2C2018:newsml_LYNXNPEE960U0:1.jpg",
"publishedAt": 1538922551,
"contentSource": "Reuters",
"categoryName": "Sports",
"categoryId": 7
},
{
"contentId": "39000cd2-1829-470a-9763-09eabc6988bd",
"title": "Lacazette, Aubameyang shine for five-star Arsenal",
"contentURL": "https://www.thestartmagazine.com/article/39000cd2-1829-470a-9763-09eabc6988bd?ref=TWFnYXppbmUtVGVzdCUkJXgwOE85U3ljZDE3TlI3MXkxOTNTdUk2WTU1cDZzYzR1JSQlMTM1Nzk4NjQy&relatedRecommenderId=topic",
"imageURL": "https://imageca.thestartmagazine.com/fetch/d_m_Sports50.jpg,c_fill,g_auto,fl_lossy,q_80/http://a3.espncdn.com/combiner/i%3Fimg=%2Fphoto%2F2018%2F1007%2Fr443344_1296x729_16%2D9.jpg",
"publishedAt": 1538945570,
"contentSource": "ESPN_INDIA",
"categoryName": "Sports",
"categoryId": 7
},
{
"contentId": "7d69bd43-877b-417f-b10e-f776ff41dec5",
"title": "Three reasons why Arsenal are back on track",
"contentURL": "https://www.thestartmagazine.com/article/7d69bd43-877b-417f-b10e-f776ff41dec5?ref=TWFnYXppbmUtVGVzdCUkJXgwOE85U3ljZDE3TlI3MXkxOTNTdUk2WTU1cDZzYzR1JSQlMTM1Nzk4NjQy&relatedRecommenderId=topic",
"imageURL": "https://imageca.thestartmagazine.com/fetch/d_m_News46.jpg,c_fill,g_auto,fl_lossy,q_80/http%3A%2F%2Fres.cloudinary.com%2Fstart4cell%2Fimage%2Fupload%2Fv1538992051%2FAFP_dbcc994a796062319984a81c2de55ee500d60211.jpg",
"publishedAt": 1538990929,
"contentSource": "AFP",
"categoryName": "News",
"categoryId": 13
}
]
}
]
}Get person
GET https://contentapi.celltick.com/mediaApi/v1.0/person/{id}
Method returns specific person info and a top article related to the selected person
Path Parameters
id
string
person name or Wikipedia id
Query Parameters
userId
string
source user id
optOut
boolean
Mandatory in case of Android application
aid
string
Mandatory in case of Android application
vendorFilter
string
comma separated list of filtered out content providers
vendor
string
comma separated list of content providers
localCountryCode
string
2 letter country code (ISO-ALPHA-2)
originCountryCode
string
2 letter country code (ISO-ALPHA-2)
publishedAfter
string
Date format MM/dd/yyyy
team
string
comma separated team list
person
string
comma separated person list
topic
string
comma separated topic list
tag
string
comma separated tag list
categoryFilter
string
comma separated list of filter out categories
category
string
comma separated list of categories
countryCode
string
2 letter country code (ISO-ALPHA-2)
language
string
2 letter language code (ISO 639-1)
{
totalItems: 1,
id: "Q22686",
name: "Donald Trump",
score365Id: 0,
score365AthleteId: 0,
sportId: 0,
freebaseId: "/m/0cqt90",
twitterId: "@realDonaldTrump",
birthDate: "Jun 14, 1946",
countryCode: "US",
gender: "m",
isHuman: true,
isFiction: false,
verticalIds: [
12,
48,
13,
],
verticalNames: [
"Entertainment",
"Finance",
"News",
],
categoryIds: [
17,
8,
75,
84,
91,
93,
],
categoryNames: [
"Celebrities",
"Movies",
"Television",
"Books",
"Mergers",
"Politics",
],
relatedPersonIds: [
"Q318508",
"Q24313",
"Q24248265",
],
relatedPersonNames: [
"Andrés Manuel López Obrador",
"Mike Pence",
"Steven Mnuchin",
],
topArticle: {
contentId: "1e067904-6403-4cdf-8433-ef71fc80f543",
title: "Washington Post: Trump Organization claims 'negative connotation' of Trump brand leads to revenue declines at Florida resort",
summary: "The Trump Organization's golf resort in Doral, Florida, has become less profitable since Donald Trump announced he was running for president four years ago, the Washington Post reported Wednesday -- a change that a company representative claimed to a local official was due to "some negative connotation that is associated with the brand."",
contentSource: "CNN_Global",
contentSourceDisplay: "CNN",
contentSourceLogo: "https://imageca.thestartmagazine.com/upload/app/CNN_512x517px.png",
categories: [
"Finance",
"News",
],
categoriesEnglish: [
"Finance",
"News",
],
iabCategories: [
53
],
images: {
mainImage: {
url: "https://imageca.thestartmagazine.com/fetch/d_magazineDefault.jpg,c_fill,g_face:auto,fl_lossy,q_70,w_480/https%3A%2F%2Fcdn.cnn.com%2Fcnnnext%2Fdam%2Fassets%2F170224130021-trump-doral-golf-video-synd-2.jpg",
width: 640,
height: 480,
},
mainImageThumbnail: {
shortURL: "https://imageca.thestartmagazine.com/fetch/t_thumbnail/https%3A%2F%2Fcdn.cnn.com%2Fcnnnext%2Fdam%2Fassets%2F170224130021-trump-doral-golf-video-synd-2.jpg",
url: "https://imageca.thestartmagazine.com/fetch/d_magazineDefault.jpg,c_fill,g_face:auto,fl_lossy,q_70,w_270,h_190/https%3A%2F%2Fcdn.cnn.com%2Fcnnnext%2Fdam%2Fassets%2F170224130021-trump-doral-golf-video-synd-2.jpg",
width: 270,
height: 190,
quality: 70,
},
additionalImages: [ ],
},
countries: [],
locale: "en_US",
publishedAt: 1557942989,
tags: [
"trump",
"doral",
"golf",
"resort",
],
persons: [
{
id: "Q22686",
name: "Donald Trump",
},
{
id: "Q3731533",
name: "Eric Trump",
},
],
topics: [
{
id: "Q2462124",
name: "The Trump Organization",
},
{
id: "Q28549308",
name: "fake news",
},
{
id: "Q850210",
name: "revenue",
},
{
id: "Q8161",
name: "tax",
},
],
views: 0,
favorites: 0,
isPreview: false,
contentURL: "https://qa.thestartmagazine.com/article/1e067904-6403-4cdf-8433-ef71fc80f543?ref=TWFnYXppbmVfZnJvbV9TdGFydGVyJSQlWEU0bjNadDcyWEtQMWNpU3cxZ1pDNzd0OUdmMGJrT3AlJCUxMzU3OTg2NDI=&language=en",
},
}GET https://contentapi.celltick.com/mediaApi/mediaApi/v1.0/category
Query Parameters
optOut
string
Allowed values are: true/false
Get team
GET https://contentapi.celltick.com/mediaApi/v1.0/team/{id}
Method returns team info.
Path Parameters
id
string
team Wikipedia id
Query Parameters
optOut
boolean
Mandatory in case of Android applications
aid
string
Mandatory in case of Android applications
language
string
2 letter language code (ISO 639-1)
userId
string
source user id (UUID)
{
totalItems: 1,
id: "Q8682",
name: "Real Madrid",
score365Id: 131,
freebaseId: "/m/06l22",
twitterId: "@realmadrid",
creationDate: "Jan 1, 1902",
countryCode: "ES",
countryId: 2,
sportType: "soccer",
sportId: 1,
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/131",
relatedTeams: [
{
id: 132,
name: "FC Barcelona",
countryId: 2,
sportId: 1,
wikiId: "Q7156",
},
{
id: 106,
name: "Chelsea",
countryId: 1,
sportId: 1,
wikiId: "Q9616",
},
],
leagues: [
{
id: 572,
name: "Champions League",
},
{
id: 11,
name: "LaLiga",
},
{
id: 13,
name: "Copa del Rey",
},
{
id: 5096,
name: "Club World Cup",
},
{
id: 6267,
name: "International Champions Cup",
},
{
id: 6280,
name: "Audi Cup",
},
],
relatedPersons: [
{
id: "Q1835",
name: "Zinedine Zidane",
},
{
id: "Q214204",
name: "Eden Hazard",
},
{
id: "Q83106",
name: "Jürgen Klopp",
},
{
id: "Q11571",
name: "Cristiano Ronaldo",
},
{
id: "Q313000",
name: "Mauricio Pochettino",
},
],
verticles: [
{
id: 7,
name: "Sports",
}
],
categories: [
{
id: 37,
name: "Soccer",
}
],
}Follow person
GET https://contentapi.celltick.com/mediaApi/v1.0/person/{personId}/add
Method allows user to start follow a specific person. method returns user data after the change.
Path Parameters
personId
string
Wikipedia id
Query Parameters
optOut
string
Mandatory in case of Android application
aid
string
Mandatory in case of Android application
userId
string
source user id (UUID)
{
publisherId: "pubId",
userId: "12345678",
persons: [
"Q1744"
],
teams: []
}Unfollow person
GET https://contentapi.celltick.com/mediaApi/v1.0/person/{personId}/delete
Method allows user to stop following a person. method returns user data after the change.
Path Parameters
personId
string
Wikipedia id
Query Parameters
optOut
string
Mandatory in case of Android application
aid
string
Mandatory in case of Android application
userId
string
source user id (UUID)
{
publisherId: "pubId",
userId: "12345678",
persons: [
"Q1744"
],
teams: []
}Get user data
GET https://contentapi.celltick.com/mediaApi/v1.0/user/{id}
Method return user data including followed persons and teams.
Path Parameters
id
string
user id
Query Parameters
sportType
integer
Specific sport type(1=soccer, 2=basketball, 6=football)
competitionId
integer
Specific competition id
aid
string
Mandatory in case of Android application
optOut
string
Mandatory in case of Android application
{
publisherId: "Magazine_from_Starter",
userId: "nim_copa_333",
persons: [Q1234,Q46778],
teams: [
{
country_id: 66,
team_id: 2388,
sport_id: 1,
},
{
country_id: 169,
team_id: 2390,
sport_id: 1,
},
{
country_id: 152,
team_id: 5422,
sport_id: 1,
},
{
country_id: 199,
team_id: 5614,
sport_id: 1,
},
],
}Last updated