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=gtaank&access_token=PLACE_ACCESS_TOKEN

Example Response

{
  id: 128894906,
  screen_name: "gtaank",
  twitter_id: 128894906,
  influence: [
    {
      topic: "indian startups",
      concept_score: 93,
      count: 89,
      experts: [
        {
          id: "http://twitter.com/ptc",
          score: "92",
          twitter_id_str: "14320997",
          twitter_screen_name: "pjain",
          twitter_screen_name_cs: "pjain",
          geom_loc: {
             lat: 40.7127837,
             lng: -74.0059413
          },
          geom_location: "40.7127837,-74.0059413",
          rr_location: "New York, NY",
          rr_location_country: "USA",
          rr_location_state: "New York"          
          primary_tags_scores: [
            { tag: "indian startups", score: "94", count: "94" },
            { tag: "500 startups", score: "89", count: "150" },
            { tag: "founders", score: "76", count: "55" },
            { tag: "angel investing", score: "75", count: "647" },
            { tag: "venture capital", score: "75", count: "540" }
          ]
        },
        {
          id: "http://twitter.com/sairee",
          score: "91",
          twitter_id_str: "17463140",
          twitter_screen_name: "sairee",
          twitter_screen_name_cs: "Sairee",
          rr_location: "",
          rr_location_country: "",
          primary_tags_scores: [
            { tag: "indian startups", score: "96", count: "80" },
            { tag: "asia", score: "96", count: "82" },
            { tag: "recruitment", score: "94", count: "93" },
            { tag: "human resources", score: "88", count: "245" },
            { tag: "founders", score: "87", count: "659" }
          ]
        }
      ]
    },
    { 
      topic: "indian bloggers",
      concept_score: 75,
      count: 87,
      experts: [
        ... (list of 2 influencers) ...
      ]
    },
    ... (max 25 topics of influence) ...
  ]
}

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 *