Articles by Influencers from a Location API

This API returns relevant articles for a given topic from a set of Right Relevance topical Influencers from a specified location in near real-time. Right Relevance platform supports over 2.5M influencers and 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/experts/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: san jose, ca; sydney, australia

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

Example Request

GET https://api.rightrelevance.com/v2/articles/experts/location?query=internet%20of%20things&location=san%20jose,%20ca&access_token=PLACE_ACCESS_TOKEN

Example Response

{
   "numFound": 82,
   "start":0,
   "maxScore":"98",
   "minScore":"59"
   "articles":[
      {
         "experts":[
            {
		twitter_followers_count: 49963,
		twitter_id_str: "14604911",
		id: "http://twitter.com/netgear",
		twitter_listed_count: 897,
		twitter_sf_count: 1441,
		twitter_screen_name: "netgear",
		twitter_friends_count: 171,
		name: "NETGEAR",
		description: "Worldwide provider of innovative networking products that keep you connected. WiFi | Switching | Smart Home Security | Network Storage",
		image_url: "http://pbs.twimg.com/profile_images/736299878926553088/QOosnco4_normal.jpg",
		social_reach: 49963,
		rr_score: 5803.6,
		topic_score: "68",
		tweet: {
			isRetweet: "false",
			tweetID: "837755736629346308",
			expert: "14604911",
			date: "Fri Mar 03 20:05:07 +0000 2017",
			text: "In today's NETGEAR podcast, Tech Communications Evangelist @NanSanFran talks #IoT & the #ConnectedHome! Listen here: ",
			favCount: "3",
			reTweetCount: "0"
		}
            },
            ... (2 more sharing RR influencers ... )
            {
		twitter_followers_count: 649,
		twitter_id_str: "3566511",
		id: "http://twitter.com/jtotheloo",
		twitter_listed_count: 53,
		twitter_sf_count: 97,
		twitter_screen_name: "jtotheloo",
		twitter_friends_count: 503,
		name: "Jen",
		description: "¯\_(ツ)_/¯. living my best life. tech pr. (for @intuit and @BlackBerryNews). san francisco girl by way of santa cruz. UCSB alum. i really like Mexico y gatos.",
		image_url: "http://pbs.twimg.com/profile_images/556347295151562752/oPhgi9SX_normal.jpeg",
		social_reach: 649,
		rr_score: 112.60000000000001,
		topic_score: "10",
		tweet: {
			isRetweet: "true",
			tweetID: "837783862008758272",
			expert: "3566511",
			date: "Fri Mar 03 21:56:52 +0000 2017",
			text: "RT @NETGEAR: In today's NETGEAR podcast, Tech Communications Evangelist @NanSanFran talks #IoT & the #ConnectedHome! Listen here: ",
			favCount: "9",
			reTweetCount: "6"
		}
            }
         ],
	id: "f64fa02143fae00c12e859b953509108bd60d627",
	image_width: "500",
	share_count: 4,
	video_html: "", content_type: "video", url: "https://soundcloud.com/user-43474393/tech-communications-evangelist-nancy-blair-on-iot-and-the-connected-home", title: "Tech Communications Evangelist Nancy Blair on IoT and the Connected Home by NETGEAR Podcast", image_height: "500", image_url: "https://i1.sndcdn.com/artworks-000210297897-k18bf8-t500x500.jpg", earliest_known_date: "2017-03-03T20:05:07Z", score: 0.03724423, related_concepts: [ "home automation", "wifi", "consumer electronics" ], excerpt: "Nancy is VP of Content at Access Emanate, NETGEAR’s PR agency. She has over twenty years...", source: "soundcloud.com" } ], "facets":{ "related_topics":[ { tag: "virtualization", count: 12 }, { tag: "cloud computing", count: 11 }, { tag: "data center", count: 11 }, { tag: "big data", count: 10 }, { tag: "cisco systems inc", count: 10 }, { tag: "telecommunications", count: 10 }, { tag: "manufacturing industry", count: 9 }, { tag: "semiconductors", count: 9 }, { tag: "enterprise storage", count: 8 }, { tag: "information security", count: 8 }, { tag: "computer software", count: 7 }, { tag: "enterprise software", count: 7 }, { tag: "software as a service", count: 7 } ] } }

Response Fields
The above API call returns 1 article (rows=1) for the topic ‘internet of things’ from ‘san jose, 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 *