Autocomplete Influencers API

This API provides auto-complete suggestions for influencer accounts from Twitter in the Right Relevance platform. It covers over 2.5M accounts classified across over 45K topics. You can see it in action at http://rightrelevance.com. Resource URL GET https://api.rightrelevance.com/v2/experts/autocomplete?q=<string> Parameters query=string (required) ‘string’ for which to lookup influencer account auto-complete suggestions Example Request GET https://api.rightrelevance.com/v2/experts/autocomplete?q=ember&access_token=PLACE_ACCESS_TOKEN Example Response […]

Continue reading


Friends Topical Distribution API

This API returns friends’ distribution across Right Relevance structured topics for a given Twitter account specified by screen_name or twitter ID. This is accomplished by mapping influential following distribution. This essentially maps the interest graph of the given user. Resource URL GET https://api.rightrelevance.com/v2/analytics/friends?screen_name=<twitter_screen_name>&access_token=<api_token> Parameters screen_name=twitter_screen_name (required) Twitter screen_name to fetch followers topical distribution Example Values: […]

Continue reading


Followers Topical Distribution API

This API returns followers’ distribution across Right Relevance structured topics for a given Twitter account specified by screen_name or twitter ID. This is accomplished by mapping influential followers distribution. Resource URL GET https://api.rightrelevance.com/v2/analytics/followers?screen_name=<twitter_screen_name>&access_token=<api_token> Parameters screen_name=twitter_screen_name (required) Twitter screen_name to fetch followers topical distribution Example Values: ml_toparticles, unhumanrights Example Request GET https://api.rightrelevance.com/v2/analytics/followers?screen_name=unhumanrights&access_token=PLACE_ACCESS_TOKEN Example Response { id: […]

Continue reading


Topics Recommendation

This API provides topic recommendations for a given Twitter account specified by the screen_name or twitter_id. Resource URL GET https://api.rightrelevance.com/v2/analytics/topics/recommended?screen_name=<twitter_screen_name>&access_token=<api_token> Parameters screen_name=twitter_screen_name (required) Twitter screen_name to fetch influencer details Example Values: vmishrra, iot_rr Example Request GET https://api.rightrelevance.com/v2/analytics/topics/recommended?screen_name=vmishrra&access_token=PLACE_ACCESS_TOKEN Example Response [ { image_url: “http://api.ning.com:80/files/eW6JlVBe1noHQ2UCCLTZ6Hwy6qJshNcerhyrZdQwufVoS5VkuKwe4Dk1syaYaAzSJpVwqlgi7QGdpG*VeDy9fjmKRJE2Qzc*/StarWars.jpg?width=750”, image_width: “750”, image_height: “1131”, topic: “data analysis” }, { image_url: “http://api.ning.com:80/files/zvnsiuM0961D8TIIC4-pslWI4OvXoph4gZ6Ae4ol34GCUKc-q2nBpZp1bddo3p2CuWegcYgMMJbnZBDQYwnf7HZ1oSMTQ-91/bigdataoverloadedtruck.jpg”, image_width: […]

Continue reading


Related Topics API

This API provides related topics for a list of specified topics. Resource URL GET https://api.rightrelevance.com/v2/topics/relatedtopics?topics=t1,t2,t3&access_token= Parameters topics=t1,t2,t3 (required) list of topic for which to fetch related topics Example Values: big data, particle physics Example Request GET https://api.rightrelevance.com/v2/topics/relatedtopics?topics=emergency medicine,philosophy,behavioral economics&access_token=PLACE_ACCESS_TOKEN Example Response { emergency medicine: { numFound: 15, related_topics: [ “emergency medical services”, “intensive care medicine”, […]

Continue reading


Topics Images API

This API provides image URLs for a list of specified topics. Resource URL GET https://api.rightrelevance.com/v2/topics/getimages?topics=t1,t2,t3&access_token= Parameters topics=t1,t2,t3 (required) list of topic for which to fetch images Example Values: archaeology, orthopedics Example Request GET https://api.rightrelevance.com/v2/topics/getimages?topics=anthropology,alzheimers&access_token=PLACE_ACCESS_TOKEN Example Response { alzheimer’s disease: { image_height: “288”, image_width: “1000”, image_url: “http://alzheimerheadlines.com/wp-content/uploads/2011/12/alzheimerheader.png” }, anthropology: { image_height: “450”, image_width: “800”, image_url: “http://www.kob.com/kobtvimages/repository/2016-08/UNM_professor_found_to_sexually_harass_discriminate_returns_to_classroom-syndImport-113118.jpg” […]

Continue reading


Conversations Search API

This API returns relevant conversations from Right Relevance Influencers for a specified topic. Note: Generally conversations are stored for a maximum of 2 weeks. Resource URL GET https://api.rightrelevance.com/v2/conversations/search?query=<topic> Parameters query=topic (required) Search ‘topic’ for which to fetch conversations Example Values: bioinformatics, social media Example Request GET https://api.rightrelevance.com/v2/conversations/search?query=bioinformatics&access_token=PLACE_ACCESS_TOKEN Example Response { num_found: 2284, conversations: [ { […]

Continue reading


Article Lookup API

This API returns details for a specified article from the Right Relevance platform. Note: Articles are generally stored for a period of 60-days. Resource URL GET https://api.rightrelevance.com/v2/articles/lookup?articleid=<article_id>&access_token=<token> Parameters articleid=article_id (required) Article ID for the article for which details are being looked up. Example Request GET https://api.rightrelevance.com/v2/articles/lookup?articleid=ARTICLE_ID_GUID&access_token=PLACE_ACCESS_TOKEN Example Response { id: “60c4cc89fc19b5ca1f32b379c4e790ec683c26e9”, image_width: “1200”, content_type: “article”, […]

Continue reading


Conversations by Influencer API

This API returns the relevant conversations a specified Right Relevance Influencer engaged in on Twitter over the previous 2 weeks. Resource URL GET https://api.rightrelevance.com/v2/conversations/search?screen_name=<screen_name>&access_token=<token> Parameters screen_name=twitter_screen_name (required) Lookup conversations shared by an Influencer specified by Twitter screen_name. Example Values: pmarca, DalaiLama Example Request GET https://api.rightrelevance.com/v2/conversations/search?screen_name=nntaleb;&access_token=PLACE_ACCESS_TOKEN Example Response { num_found: 96, conversations: [ (… more conversations […]

Continue reading