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",
    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 *