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":[
      {
         "experts":[
            {
               "twitter_followers_count":93952,
               "twitter_id_str":"81083096",
               "id":"http://twitter.com/etmarkets",
               "twitter_sf_count":586,
               "twitter_screen_name":"etmarkets",
               "name":"ETMarkets",
               "description":"Welcome! You have just landed on India's No. 1 platform for #news and #views on #financialmarkets. Stay hooked to follow every market move round the clock.",
               "image_url":"http://pbs.twimg.com/profile_images/702713093583872001/Gq4JVTVO_normal.png",
               "topic_score":"94",
               "tweet":{
                  "isRetweet":"false",
                  "tweetID":"758667132104118273",
                  "expert":"81083096",
                  "date":"Thu Jul 28 14:15:14 +0000 2016",
                  "text":"Tech view: #Nifty50 forms ‘Small Bull’ candle on charts; keep stop loss at 8,570  ",
                  "favCount":"1",
                  "reTweetCount":"2"
               }
            },
            ... (3 more sharing RR influencers ... )
            {
               "twitter_followers_count":3451,
               "twitter_id_str":"89893125",
               "id":"http://twitter.com/indianews247",
               "twitter_sf_count":85,
               "twitter_screen_name":"indianews247",
               "name":"IndiaNews247",
               "description":"Breaking News,India News 24X7, World, Weather, Entertainment & Video ........",
               "image_url":"http://pbs.twimg.com/profile_images/1872648415/INDIANEWS247_normal.JPG",
               "topic_score":"10",
               "tweet":{
                  "isRetweet":"false",
                  "tweetID":"758659661713121281",
                  "expert":"89893125",
                  "date":"Thu Jul 28 13:45:33 +0000 2016",
                  "text":"Tech view: Nifty50 forms ‘Small Bull’ candle on charts; keep stop loss at 8,570 ",
                  "favCount":"0",
                  "reTweetCount":"0"
               }
            }
         ],
         "id":"322920c872fdeaab62e8f8bf42e26413abd45556",
         "share_count":6,
         "content_type":"article",
         "url":"http://economictimes.indiatimes.com/markets/stocks/news/tech-view-nifty50-forms-small-bull-candle-on-charts-keep-stop-loss-at-8570/articleshow/53435436.cms",
         "title":"Tech view: Nifty50 forms ‘Small Bull’ candle on charts; keep stop loss at 8,570 - The Economic Times",
         "image_width":"-1",
         "image_height":"-1",
         "image_url":"http://img.etimg.com/photo/53435459/.jpg",
         "earliest_known_date":"2016-07-28T13:45:30Z",
         "related_concepts":[
            "defense technology",
            "broadsheets",
            "south asia"
         ],
         "excerpt":"NEW DELHI: The bulls were back in action on Dalal Street on Thursday, as the Nifty50 managed to stage a smart rally in the last one hour of trade, forming a 'Small Bull' candle on the daily candlestick chart. The Nifty50 hit a fresh 52-week high of 8,674.70 in trade on a day when the July F&O series expired, which is a comforting sign for the bulls. Based on the trading activity witnessed so far during the week, investors can build long positions on Nifty50 with a stop loss at 8,570. The trade remained muted for most part of the session but value buying at lower levels pulled the index beyond the 8,650 level towards closing. It has to sustain at 8,625 level for the buying momentum to sustain, experts said. A 'Small Bullish' candle is formed when the index trades higher but within a defined range throughout the session. The length of the candle signifies the trading range for the day. The Nifty50, which opened at 8,636, rose to a 52-week high of 8,674, forming a small upper shadow. It slipped to an intraday low of 8,625, which resulted in a small lower shadow before closing at 8,666. In general, the longer the candle, the more intense is the buying or selling activity. If the candles are short, just as the one we observed on the charts on Thursday, it can be concluded that the trading action was subdued, but on the positive side.",
         "source":"economictimes.indiatimes.com"
      }
   ],
   "facets":{
      "related_topics":[
         {
            "tag":"stock markets",
            "count":124
         },
         {
            "tag":"indian economy",
            "count":78
         },
         {
            "tag":"chief marketing officer",
            "count":54
         },
         {
            "tag":"indian startups",
            "count":54
         },
         {
            "tag":"economy market",
            "count":51
         },
         {
            "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 *