Topical Articles Lookup API

This API provides recent relevant articles for the specified topic. Unlike ‘Articles Search’, this API is a pure lookup, much faster and limited to the last 2-3 days.

Resource URL

GET http://api.rightrelevance.com/v2/topics/getarticles?topic=<topic>&start=X&rows=Y&access_token=

Parameters

topic=string

(required)

topic for which to fetch recent article

Example Values: archaeology, orthopedics

start=X

(optional)
Returns articles starting from index ‘X’. Default: 0

Example Values: 0

rows=Y

(optional)
Number of articles ‘Y’ to return. Default: 20

Example Values: 9

Example Request

GET http://api.rightrelevance.com/v2/topics/getarticles?topic=uk%20politics&start=0&rows=5&access_token=PLACE_ACCESS_TOKEN

Example Response

{
    numFound: 20,
    articles: {
        articles_count: 5,
        article_data: [
            {
                experts: [
                    {
                        twitter_followers_count: 35316,
                        twitter_id_str: "31105169",
                        id: "http://twitter.com/indypolitics",
                        twitter_sf_count: 2892,
                        twitter_screen_name: "indypolitics",
                        name: "Indy Politics",
                        description: "Politics news from the world's most free-thinking newspaper",
                        image_url: "http://pbs.twimg.com/profile_images/591208701492596736/1uo2FHu1_normal.png",
                        social_reach: 35316,
                        rr_score: 4882.5,
                        location: {
                            latitude: "",
                            longitude: "",
                            name: ""
                        },
                        primary_tags_scores: [
                            {
                                tag: "uk politics",
                                score: "84",
                                count: "377"
                            },
                            {
                                tag: "uk general election",
                                score: "84",
                                count: "129"
                            },
                            {
                                tag: "political journalism",
                                score: "83",
                                count: "128"
                            },
                            {
                                tag: "msps",
                                score: "83",
                                count: "137"
                            },
                            {
                                tag: "uk's eu referendum",
                                score: "76",
                                count: "91"
                            }
                        ],
                        topic_score: "84",
                        tweet: {
                            isRetweet: "false",
                            tweetID: "762322946165727232",
                            expert: "31105169",
                            date: "Sun Aug 07 16:22:08 +0000 2016",
                            text: "Jeremy Corbyn could introduce a six-hour work day ",
                            favCount: "0",
                            reTweetCount: "0"
                        }
                    },
                    {
                        twitter_followers_count: 1977757,
                        twitter_id_str: "16973333",
                        id: "http://twitter.com/independent",
                        twitter_sf_count: 44332,
                        twitter_screen_name: "independent",
                        name: "The Independent",
                        description: "News, comment and features from The Independent.",
                        image_url: "http://pbs.twimg.com/profile_images/583628771972018176/ztJn926g_normal.png",
                        social_reach: 1977757,
                        rr_score: 213919.90000000002,
                        location: {
                            latitude: "",
                            longitude: "",
                            name: ""
                        },
                        primary_tags_scores: [
                            {
                                tag: "television",
                                score: "87",
                                count: "5889"
                            },
                            {
                                tag: "politics",
                                score: "86",
                                count: "10452"
                            },
                            {
                                tag: "journalism",
                                score: "86",
                                count: "4286"
                            },
                            {
                                tag: "news media",
                                score: "84",
                                count: "1994"
                            },
                            {
                                tag: "world news",
                                score: "84",
                                count: "1441"
                            }
                        ],
                        topic_score: "10",
                        tweet: {
                            isRetweet: "false",
                            tweetID: "762322151273791488",
                            expert: "16973333",
                            date: "Sun Aug 07 16:18:58 +0000 2016",
                            text: "Jeremy Corbyn could introduce a six-hour work day ",
                            favCount: "17",
                            reTweetCount: "12"
                        }
                    }
                ],
                id: "c86a31d0ff9da18a071523be2bd1d3ebce18d4d7",
                image_width: "1128",
                share_count: 2,
                content_type: "article",
                url: "http://www.independent.co.uk/news/uk/politics/jeremy-corbyn-six-hour-day-workplace-2020-reduce-work-hours-a7177661.html",
                title: "Jeremy Corbyn could introduce a six-hour work day",
                image_height: "746",
                image_url: "http://static.independent.co.uk/s3fs-public/thumbnails/image/2016/07/30/12/jeremy-corbyn.png",
                earliest_known_date: "2016-08-07T16:18:58Z",
                redirect_policy: "no",
                score: 1.8155881,
                related_concepts: [
                    "world news",
                    "uk general election",
                    "television"
                ],
                excerpt: "UK Politics Jeremy Corbyn says he will discuss reducing working day down to just six hours The Labour leader's suggestion follows experiments in Sweden which found a six hour working day increases employee happiness, productivity and profit Siobhan Fenton Health and Social Affairs correspondent @siobhanfenton Sunday 7 August 2016 17:20 BST Jeremy Corbyn has said he is open to the proposals which are currently being tried in Europe Getty Jeremy Corbyn has said he will discuss proposals to reduce the working day to just six hours. While it might sound like wishful thinking, the significantly shorter working day is championed by psychologists and academics who say it is better for workers’ productivity and satisfaction than a traditional 9-to-5 routine. Some European countries have begun trialling the change and preliminary reports suggest workers say they are feeling more focused, more productive and company profits have increased."
                source: "independent.co.uk",
                earliest_known_date_timestamp_sec: 1470586685,
                _id: "c86a31d0ff9da18a071523be2bd1d3ebce18d4d7",
                topic: "uk politics"
            },
            ... (4 more articles) ...
        ]
    }
}

Response Fields

Returns recent articles for the specified topic, which is ‘uk politics’ in this example.

numFound

Total recent articles for the specified topic
articles

List of articles for the specified topic
articles.articles_count

Count of articles in the current list (depends on rows=Y)
articles.article_data

Article specific data like share count, sharing expert, title etc.

Write a Reply or Comment

Your email address will not be published. Required fields are marked *