Articles Search from a Location API

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/search/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/search?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_followers_count: 4354,
		twitter_id_str: "337892581",
		id: "http://twitter.com/agentcaff",
		twitter_listed_count: 324,
		twitter_sf_count: 768,
		twitter_screen_name: "agentcaff",
		twitter_friends_count: 2167,
		name: "Agent Caffeine",
		description: "See the most powerful leaders & producers in #RealEstate #Brokers & #Tech #1 show on the internet for innovation, best practices & strategy. #AgentCaff #TheBuzz",
		image_url: "http://pbs.twimg.com/profile_images/470733517328904192/peHzpufo_normal.jpeg",
		social_reach: 4354,
		rr_score: 727,
		topic_score: "76",
		tweet: {
			isRetweet: "false",
			tweetID: "837824189595807744",
			expert: "337892581",
			date: "Sat Mar 04 00:37:07 +0000 2017",
			text: "via @Realtors How Do Your Property Taxes Stack Up? - The average American household spends $2,149 on property t... ",
			favCount: "0",
			reTweetCount: "0"
		}
            },
            ... (4 more sharing RR influencers ... )
            {
		twitter_followers_count: 415,
		twitter_id_str: "21926449",
		id: "http://twitter.com/thegeronsins",
		twitter_listed_count: 29,
		twitter_sf_count: 48,
		twitter_screen_name: "thegeronsins",
		twitter_friends_count: 211,
		name: "The Geronsins",
		description: "A distinguished top producing #realestate team with exceptional customer service & knowledge. We engage in sales of #FineHomes, Standard & #ShortSales, & #REOs",
		image_url: "http://pbs.twimg.com/profile_images/749242366/Geronsins_-_Copy__2__normal.jpg",
		social_reach: 415,
		rr_score: 67.6,
		topic_score: "10",
		tweet: {
			isRetweet: "false",
			tweetID: "837711252021526528",
			expert: "21926449",
			date: "Fri Mar 03 17:08:21 +0000 2017",
			text: "How Do Your Property Taxes Stack Up? ",
			favCount: "0",
			reTweetCount: "0"
		}
            }
         ],
	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. Its effective tax rate of 2.35 percent means homeowners there pay about $7,410 annually on a $316,000 home, the median sales price in the state. On the other hand, Hawaii has the lowest property taxes in the nation. At just a 0.",
	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

Write a Reply or Comment

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