This API returns relevant articles for a given topic from a specified location in near real-time. Right Relevance platform supports over 10K structured locations in the form “city, state” for the US & Canada and “city, country” for rest of the world. It’s paginated with articles provided in time sorted oder.
Note: Generally articles are stored for a maximum of 45 days.
Resource URL
GET https://api.rightrelevance.com/v2/articles/location?query=<topic>&location=<location>
Parameters
| query=topic
(required)
|
Search ‘topic’ to fetch articles
Example Values: hadoop, marketing, social media |
| location=rr_location
(required)
|
‘Location’ to fetch articles
Example Values: new york, ny; london, uk |
| start=X
(optional)
|
Returns articles starting from index ‘X’. Default: 0
Example Values: 0 |
| rows=Y
(optional)
|
Number of articles ‘Y’ to return. Default: 10
Example Values: 10 |
Example Request
GET https://api.rightrelevance.com/v2/articles/location?query=real%20estate&location=san%20francisco,%20ca&start=0&rows=1&access_token=PLACE_ACCESS_TOKEN
Example Response
{
"numFound": 1484,
"start":0,
"maxScore":"98",
"minScore":"40"
"articles":[
{
"experts":[
{
"twitter_id_str": "337892581",
"id": "http://twitter.com/agentcaff",
"twitter_screen_name"": "agentcaff",
"topic_score: "76",
"tweet: {
"tweet_id": "837824189595807744",
"date": "Sat Mar 04 00:37:07 +0000 2017",
}
},
... (4 more sharing RR influencers ... )
{
"twitter_id_str": "21926449",
"id": "http://twitter.com/thegeronsins",
"twitter_screen_name": "thegeronsins",
"topic_score": "10",
"tweet": {
"tweet_id": "837711252021526528",
"date": "Fri Mar 03 17:08:21 +0000 2017",
}
}
],
"id": "3b125dac6ecb5c6cb958cd9b6a6298961f94bdf9",
"url": "http://realtormag.realtor.org/daily-news/2017/03/03/how-do-your-property-taxes-stack-up",
"title": "How Do Your Property Taxes Stack Up?",
"image_url": "http://realtormag.realtor.org/sites/all/themes/rmotheme/images/bkg/RM_logo-print-page.gif",
"content_type": "article",
"earliest_known_date": "2017-03-03T17:06:28Z",
"share_count": 29,
"score": 4.069389,
"related_concepts": [
"mortgages",
"hawaii",
"real estate agents"
],
"excerpt": "The average American household spends $2,149 on property taxes for their homes each year, according to U.S. Census data. But depending on where you live, that can vary drastically. For the third consecutive year, New Jersey ranks as having the highest property taxes in the nation, according to a new report released by WalletHub.",
"image_height": "",
"image_width": "",
"source": "realtormag.realtor.org"
}
],
"facets":{
"related_topics":[
{ tag: "real estate agents", count: 50 },
{ tag: "commercial real estate", count: 41 },
{ tag: "mortgages", count: 35 },
{ tag: "san francisco ca", count: 31 },
{ tag: "real estate investing", count: 22 },
{ tag: "northern california", count: 20 },
{ tag: "inman", count: 19 },
{ tag: "sf bay area", count: 19 },
{ tag: "construction industry", count: 18 },
{ tag: "silicon valley", count: 18 },
{ tag: "urban planning", count: 17 },
{ tag: "usa", count: 17 },
{ tag: "luxury real estate", count: 15 }
]
}
}
Response Fields
The above API call returns 1 article (rows=1) for the topic ‘real estate’ from ‘san francisco, ca’. 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 |