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

Example Request

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

Example Response

{
    id: 203983366,
    screen_name: "hardeepmonty",
    name: "Hardeep Singh",
    description: "Everything UI/UX @rightrelevance, B-Tech CSE from IIT, Startup Enthusiast.",
    verified: false,
    followers_count: 446,
    friends_count: 129,
    listed_count: 51,
    profile_background_image_url_https: "https://pbs.twimg.com/profile_background_images/213483918/WallPaper_HD_-_3159.jpg",
    profile_image_url_https: "https://pbs.twimg.com/profile_images/429562354364207104/wuW_qAR0_normal.jpeg",
    profile_text_color: "333333",
    interests: [
        {
            topic: "entrepreneurship",
            count: 15
        },
        {
            topic: "personal branding",
            count: 14
        },
        {
            topic: "social media",
            count: 13
        },
        {
            topic: "search engine optimization",
            count: 12
        },
        {
            topic: "business",
            count: 11
        },
        {
            topic: "social media marketing",
            count: 10
        },
        {
            topic: "marketing",
            count: 9
        },
        {
            topic: "technology",
            count: 9
        },
        {
            topic: "authors",
            count: 9
        },
        {
            topic: "public relations",
            count: 9
        },
        {
            topic: "productivity",
            count: 9
        },
        {
            topic: "startups",
            count: 9
        },
        {
            topic: "blogging",
            count: 8
        },
        {
            topic: "freelancing",
            count: 8
        },
        {
            topic: "web design",
            count: 8
        },
        {
            topic: "small businesses",
            count: 7
        },
        {
            topic: "facebook",
            count: 7
        },
        {
            topic: "online marketing",
            count: 7
        },
        {
            topic: "advertising",
            count: 6
        },
        {
            topic: "web 2.0",
            count: 6
        },
        {
            topic: "seed accelerators",
            count: 6
        },
        {
            topic: "linkedin",
            count: 6
        },
        {
            topic: "founders",
            count: 6
        },
        {
            topic: "digital marketing",
            count: 5
        },
        {
            topic: "web development",
            count: 5
        }
    ]
}

Response Fields

Returns friends’ topical distribution for ‘hardeepmonty’. Most fields are self-explanatory.