Articles Search API

This API returns relevant articles for a given topic in near real-time. It’s paginated and supports both relevance and time sorting orders.
Note: Generally articles are stored for a maximum of 60 days.

Resource URL

GET https://api.rightrelevance.com/v2/articles/search?query=<topic>

Parameters

query=topic

(required)
Search ‘topic’ to fetch articles

Example Values: hadoop, marketing, social media

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: 10

orderby=sort_order

(optional)
Sorting order for returned articles. Default: relevance

Example Values: time, relevance

content_type=type

(optional)
Type (all, video-only) of articles to return. Default: all

Example Values: all, video

max_score=MAX

(optional)
Maximum influencer score in the specified topic for searching articles. Default: 100

Example Values: 70, 90

min_score=MIN

(optional)
Minimum influencer score in the specified topic for searching articles. Default: 10

Example Values: 10, 25

days=DAYS

(optional)
Number of ‘DAYS’ for which to return articles.

Example Values: 14

Example Request

GET https://api.rightrelevance.com/v2/articles/search?query=indian%20stock%20market&start=0&rows=1&access_token=PLACE_ACCESS_TOKEN

Example Response

{
   "numFound":1797,
   "start":0,
   "maxScore":"98",
   "minScore":"33",
   "articles":[
      {
         "id":"322920c872fdeaab62e8f8bf42e26413abd45556",
         "share_count":6,
         "content_type":"article",
         "url":""https://www.business-standard.com/article/markets/chart-reading-diamond-pattern-suggests-upside-for-nifty50-and-bse-sensex-119011400093_1.html",
         "title":"Chart Reading: Diamond pattern suggests upside for Nifty50 and BSE Sensex",
         "image_width":"620",
         "image_height":"464",
         "image_url":"https://bsmedia.business-standard.com/_media/bs/img/article/2018-06/11/full/1528656043-2421.jpg",
         "earliest_known_date":"2019-01-14T04:22:35Z",
         "latest_updation_time": "2019-01-14T06:35:15Z",
         "excerpt":"On Friday, the S&P BSE Sensexdropped 96 points, or 0.27 per cent to close at 36,009 while the Nifty50index fell 26 points or 0.25 per cent to end at 10,794. On the weekly scale, both the indices closed in the positive territory. The 30-share index Sensex closed 0.88 per cent higher with a green candle. Nifty settled 0.62 per cent up with a 'doji' formation on the chart.",
         "source":"economictimes.indiatimes.com",
         "related_concepts":[
            "narendra modi",
            "indian media",
            "indian economy"
         ],
         "experts":[
            {
               "twitter_id_str":"81083096",
               "id":"http://twitter.com/etmarkets",
               "twitter_screen_name":"etmarkets",
               "topic_score":"94",
               "tweet":{
                  "tweet_id":"758667132104118273",
                  "date":"Thu Jul 28 14:15:14 +0000 2016"
               }
            },
            ... (3 more sharing RR influencers ... )
            {
               "twitter_id_str":"89893125",
               "id":"http://twitter.com/indianews247",
               "twitter_screen_name":"indianews247",
               "topic_score":"10",
               "tweet":{
                  "tweet_id":"758659661713121281",
                  "date":"Thu Jul 28 13:45:33 +0000 2016"
               }
            }
         ]
      }
   ],
   alt_forms: [
     "indian stock market",
     "indian stocks",
     "dalal street",
     "sensex",
     "indianstocks",
     "bombay stock exchange",
     "nifty50"
   ],
   "facets":{
      "related_topics":[
         { "tag":"stock markets", "count":124 },
         { "tag":"indian economy", "count":78 },
         { "tag":"indian startups", "count":54 },
         { "tag":"financial markets", "count":44 },
         { "tag":"indian media", "count":41 },
         { "tag":"indian news", "count":40 },
         { "tag":"asset management", "count":37 },
         { "tag":"day trading", "count":37 },
         { "tag":"mutual funds", "count":37 },
         { "tag":"south asia", "count":36 },
         { "tag":"stocks", "count":34 }
      ]
   }
}

Response Fields
The above API call returns 1 article (rows=1) for the topic ‘indian stock market’. Most returned fields are self-explanatory.

numFound Total articles found for the queried topic
articles List of articles found for the queried topic
articles.experts List of influencers who shared/RT that article. Maximum 15
articles.share_count Number of RR influencers sharing that article
articles.title Article title
articles.excerpt Article abstract
facets Related topics to the queried topic

Write a Reply or Comment

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