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 |