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: 69231187,
    screen_name: "UNHumanRights",
    name: "UN Human Rights",
    description: "The United Nations #HumanRights office is led by High Commissioner #Zeid",
    verified: true,
    followers_count: 1462553,
    friends_count: 913,
    listed_count: 7567,
    profile_background_image_url_https: "https://pbs.twimg.com/profile_background_images/378800000019343452/e54e6c42855bfcfb9c93b850ffe40328.png",
    profile_image_url_https: "https://pbs.twimg.com/profile_images/664759128590536704/bH2WyXVh_normal.jpg",
    profile_text_color: "F5F0F5",
    expertise: [
        {
            topic: "international development",
            count: 1350
        },
        {
            topic: "united nations",
            count: 1319
        },
        {
            topic: "refugees",
            count: 1307
        },
        {
            topic: "human rights",
            count: 1292
        },
        {
            topic: "ngos",
            count: 1116
        },
        {
            topic: "civil society",
            count: 1076
        },
        {
            topic: "diplomacy",
            count: 1073
        },
        {
            topic: "migrations",
            count: 1059
        },
        {
            topic: "international relations",
            count: 997
        },
        {
            topic: "global health",
            count: 883
        },
        {
            topic: "africa",
            count: 801
        },
        {
            topic: "women's rights",
            count: 779
        },
        {
            topic: "middle east",
            count: 756
        },
        {
            topic: "middle east and north africa",
            count: 725
        },
        {
            topic: "foreign policy",
            count: 718
        },
        {
            topic: "sustainable development",
            count: 670
        },
        {
            topic: "international organizations",
            count: 670
        },
        {
            topic: "poverty",
            count: 668
        },
        {
            topic: "peace building",
            count: 641
        },
        {
            topic: "human trafficking",
            count: 640
        },
        {
            topic: "immigration",
            count: 639
        },
        {
            topic: "democracy",
            count: 599
        },
        {
            topic: "european union",
            count: 592
        },
        {
            topic: "social justice",
            count: 583
        },
        {
            topic: "egypt",
            count: 565
        }
    ]
}

Response Fields

Returns followers’ topical distribution for ‘unhumanrights’. Most fields are self-explanatory.

expertise

List of objects with followers topical distribution (maximum 25)

Write a Reply or Comment

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