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.

Access URL for content API is available at: https://contentapi.celltick.com

Get Categories

GET https://contentapi.celltick.com/mediaApi/mediaApi/v1.0/category

Method return list of content categories

Query Parameters

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

200 Returns list of categories in system in English. Each category has id, name, translated name, and image URL. The translated name is set by the locale/language parameters to the API. The API allows filtering list of categories by locale, country and language.

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

Name	Type	Description
categoryId	string	The specific category Id

Query Parameters

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

200

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

Name	Type	Description
categoryName	string	The specific category name (English)

Query Parameters

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

200

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

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

200

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

Name	Type	Description
contentId	string	UUID format

Query Parameters

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

200

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

Name	Type	Description
id	string	person name or Wikipedia id

Query Parameters

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

200

{
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

Name	Type	Description
optOut	string	Allowed values are: true/false

200

Get team

GET https://contentapi.celltick.com/mediaApi/v1.0/team/{id}

Method returns team info.

Path Parameters

Name	Type	Description
id	string	team Wikipedia id

Query Parameters

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

200

{
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

Name	Type	Description
personId	string	Wikipedia id

Query Parameters

Name	Type	Description
optOut	string	Mandatory in case of Android application
aid	string	Mandatory in case of Android application
userId	string	source user id (UUID)

200

{
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

Name	Type	Description
personId	string	Wikipedia id

Query Parameters

Name	Type	Description
optOut	string	Mandatory in case of Android application
aid	string	Mandatory in case of Android application
userId	string	source user id (UUID)

200

{
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

Name	Type	Description
id	string	user id

Query Parameters

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

200

{
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,
},
],
}