Per Topic Follow Recommendations API

This API returns follow recommendations across Right Relevance structured topics for a given Twitter account specified by screen_name.

Resource URL

GET https://api.rightrelevance.com/v2/analytics/friends/recommendations?topic=machine%20learning&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: datavizrr, gtaank

Example Request

GET https://api.rightrelevance.com/v2/analytics/friends/recommendations?topic=machine%20learning&screen_name=gtaank&access_token=PLACE_ACCESS_TOKEN

Example Response

{
    id: 128894906,
    screen_name: "gtaank",
    name: "Gaurav Taank",
    description: "Entrepreneur, DCEite, Hustler! Waiting for robots & AI to take control of the world! Now building @rightrelevance, previously in robotics,solar,UAVs",
    verified: false,
    followers_count: 14940,
    friends_count: 7497,
    listed_count: 214,
    profile_background_image_url_https: "https://abs.twimg.com/images/themes/theme1/bg.png",
    profile_image_url_https: "https://pbs.twimg.com/profile_images/740499571000934400/0_hz9Ran_normal.jpg",
    profile_text_color: "333333",
    topic: "machine learning",
    follow_recommendations: [
        {
            id: "http://twitter.com/hmason",
            rr_location: "New York, NY",
            rr_location_country: "USA",
            rr_location_state: "ny",
            twitter_description: "Founder at @FastForwardLabs. Data Scientist in Residence at @accel. I ♥ data and cheeseburgers.",
            twitter_followers_count: 76066,
            twitter_friends_count: 1362,
            twitter_id_str: "765548",
            twitter_lang: "en",
            twitter_listed_count: 4509,
            twitter_location: "New York, NY",
            twitter_name: "Hilary Mason",
            twitter_profile_image_url: "http://pbs.twimg.com/profile_images/1290564266/me_square_normal.jpg",
            twitter_screen_name: "hmason",
            twitter_screen_name_cs: "hmason",
            twitter_statuses_count: 15675,
            twitter_verified_status: true,
            score: "98",
            primary_tags_scores: [
                {
                    tag: "data science",
                    score: "98",
                    count: "2573"
                },
                {
                    tag: "machine learning",
                    score: "98",
                    count: "1250"
                },
                {
                    tag: "data analysis",
                    score: "98",
                    count: "1175"
                },
                {
                    tag: "data mining",
                    score: "98",
                    count: "930"
                },
                {
                    tag: "artificial intelligence",
                    score: "98",
                    count: "818"
                }
            ]
        },
        .. (more follow recommendations)..
        {
            id: "http://twitter.com/simplystats",
            rr_location: "Baltimore, MD",
            rr_location_country: "USA",
            rr_location_state: "md",
            twitter_description: "Simply Statistics blog by Jeff Leek, Roger Peng, and Rafael Irizarry. Home to statistics; data; science; and Rafa's Rants.",
            twitter_followers_count: 40163,
            twitter_friends_count: 287,
            twitter_id_str: "405033226",
            twitter_lang: "en",
            twitter_listed_count: 1526,
            twitter_location: "Baltimore, MD",
            twitter_name: "Simply Statistics",
            twitter_profile_image_url: "http://pbs.twimg.com/profile_images/525742883106607106/foksIP06_normal.png",
            twitter_screen_name: "simplystats",
            twitter_screen_name_cs: "simplystats",
            twitter_statuses_count: 2479,
            twitter_verified_status: false,
            score: "86",
            primary_tags_scores: [
                {
                    tag: "r programming language",
                    score: "90",
                    count: "161"
                },
                {
                    tag: "computational biology",
                    score: "90",
                    count: "112"
                },
                {
                    tag: "statistics",
                    score: "88",
                    count: "526"
                },
                {
                    tag: "data analysis",
                    score: "87",
                    count: "430"
                },
                {
                    tag: "data science",
                    score: "86",
                    count: "753"
                }
            ]
        }       
    ]
}

Response Fields

Returns Twitter account follow recommendations for the topic ‘machine learning’ for ‘gtaank’.

follow_recommendations

List of Twitter accounts as follow recommendations (maximum 100)

Write a Reply or Comment

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