Topical Influence API

This API returns per topic influence data for a given Twitter account specified by the screen_name or twitter_id. Only Right Relevance structured topics are considered and returned.

Resource URL

GET https://api.rightrelevance.com/v2/analytics/influence?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: gtaank, mentalhealthrr

Example Request

GET https://api.rightrelevance.com/v2/analytics/influence?screen_name=iot_rr&access_token=PLACE_ACCESS_TOKEN

Example Response

{
  description: "Live #iot content curated by IoT influencers. (Pic:https://t.co/qJT3x7tXp8)",
  followers_count: 20232,
  friends_count: 8376,
  id: 2797199022,
  influence: [
    {
      topic: "industrial internet of things",
      concept_score: 93,
      count: 89,
      experts: [
        {
          twitter_followers_count: 25294,
          twitter_statuses_count: 14432,
          twitter_id_str: "207505157",
          twitter_verified_status: false,
          id: "http://twitter.com/ptc",
          twitter_listed_count: 1055,
          twitter_description: "Official Twitter account of PTC: Bringing technology solutions and leadership to the #IoT â–º https://t.co/ULz5gZHZgJ",
          twitter_lang: "en",
          twitter_location: "",
          twitter_screen_name_cs: "PTC",
          twitter_screen_name: "ptc",
          country: "",
          twitter_name: "PTC",
          twitter_friends_count: 12479,
          twitter_profile_image_url: "http://pbs.twimg.com/profile_images/739899673499033604/KWkx9RUv_normal.jpg",
          score: "94",
          primary_tags_scores: [
            {
              tag: "industrial internet of things",
              score: "94",
              count: "94"
            },
            {
              tag: "product lifecycle management",
              score: "89",
              count: "150"
            },
            {
              tag: "machine to machine",
              score: "89",
              count: "55"
            },
            {
              tag: "internet of things",
              score: "87",
              count: "647"
            },
            {
              tag: "manufacturing industry",
              score: "84",
              count: "540"
            }
          ]
        },
        {
          twitter_followers_count: 26588,
          twitter_statuses_count: 3319,
          twitter_id_str: "485661489",
          twitter_verified_status: false,
          twitter_listed_count: 731,
          id: "http://twitter.com/iotevent",
          twitter_description: "Latest news, information and innovation around the Internet of Things, Internet of People, Big Data, Connected Devices and M2M. another Jakajima Event.",
          twitter_lang: "nl",
          twitter_location: "Eindhoven, Netherlands",
          twitter_screen_name_cs: "iotevent",
          twitter_screen_name: "iotevent",
          country: "netherlands",
          twitter_name: "Internet of Things",
          twitter_friends_count: 1662,
          twitter_profile_image_url: "http://pbs.twimg.com/profile_images/1810643475/IOT_Logo_LR_normal.jpg",
          score: "94",
          primary_tags_scores: [
            {
              tag: "industrial internet",
              score: "96",
              count: "80"
            },
            {
              tag: "machine to machine",
              score: "96",
              count: "82"
            },
            {
              tag: "industrial internet of things",
              score: "94",
              count: "93"
            },
            {
              tag: "home automation",
              score: "88",
              count: "245"
            },
            {
              tag: "internet of things",
              score: "87",
              count: "659"
            }
          ]
        }
      ]
    },
    ... (max 24 other topics of influence) ...
  ],
  listed_count: 610,
  name: "Internet of Things",
  profile_background_image_url_https: "https://abs.twimg.com/images/themes/theme1/bg.png",
  profile_image_url_https: "https://pbs.twimg.com/profile_images/737876611119390720/oUs_iXer_normal.jpg",
  profile_text_color: "333333",
  screen_name: "IOT_RR",
  twitter_id: 2797199022,
  verified: false
}

Response Fields

Returns per topic influence data for ‘iot_rr’ Twitter account. Most fields are self-explanatory.

influence

List of objects with influence topics (maximum 25) with metadata
influence.topic

RR structured topic in which the user has influence
influence.concept_score

RR influence score in that topic
influence.experts

List of top 2 RR influential followers of the user in that topic

Write a Reply or Comment

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