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":[
      {
	"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",
        "experts":[
            {
		"twitter_id_str": "14604911",
		"id": "http://twitter.com/netgear",
		"twitter_screen_name": "netgear",
		"topic_score": "68",
		"tweet": {
			"tweet_id": "837755736629346308",
			"date": "Fri Mar 03 20:05:07 +0000 2017"
		}
            },
            ... (2 more sharing RR influencers ... )
            {
		"twitter_id_str": "3566511",
		"id": "http://twitter.com/jtotheloo",
		"twitter_screen_name": "jtotheloo",
		"topic_score": "10",
		"tweet": {
			"tweet_id": "837783862008758272",
			"date": "Fri Mar 03 21:56:52 +0000 2017"
		}
            }
         ]
      },
      ... (more articles by influencers from a location)....
   ], 
   "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 *