Klout 2.0


Gnip’s Klout enrichment provides valuable information about a user’s influence (score) and influencer/interest areas (topics). For Gnip’s 2.0 products, we offer a single Klout enrichment that includes a user’s influence score and up to 10 total topics, 5 each from a user’s interest and influence topical areas. We are able to deliver this information through our partnership with Klout.

Klout data will be returned for users, when available, in Gnip’s PowerTrack, Replay, Volume Stream, Search, and Historical PowerTrack APIs.

Klout Score and Profile Data


Original Format Field Name Activity Streams Field Name Example Value Description
user.derived.klout.score gnip.klout_score 27 The Klout Score of the user that created the Tweet, represented as an integer from 1 - 100.
user.derived.klout.profile_url gnip.klout_profile.link http://klout.com/user/id/651348 A link to the Klout profile for the user that created the Tweet.
user.derived.klout.user_id gnip.klout_profile.klout_user_id 651348 The Klout User ID for the user that created the Tweet.

Klout Topic Data

Alongside a user’s Klout Score, our Klout enrichment will also return data about two types of Klout Topics: influence topics and and interest topics. The enrichment will return up to a maximum of 10 total topic areas, up to 5 in each category.

Influence Topics
  • A topical category and score that indicates what specific topics or categories the user is influential in. This means that when the user Tweets or talks about these topics, he or she is influential to other people about them. Each influence topic also contains a numerical score between 0 and 1 that indicates how influential the user is in this specific category, relative to other users influential in this area. The Klout enrichment may return up to 5 influence topics for a given user.
Interest Topics
  • A topical category and score that indicates what specific topics or categories the user is interested in. This means that the user reads, consumes, engages others, or is otherwise interested (but perhaps not influential) in these topics. Each interest topic also contains a numerical score between 0 and 1 that indicates how interested the person is in this specific category. The Klout enrichment may return up to 5 interest topics for a given user.

In Original Format, Klout topic data can be found in the user.derived.klout.influence_topics and user.derived.klout.interest_topics sections of the payload.

In Activity Streams Format, Klout topic data can be found in the gnip.klout_profile_topics section of the payload.


Sample Payload

Original Format:

{
    "derived": {
        "klout": {
            "score": 27,
            "profile_url": "http://klout.com/user/id/651348",
            "user_id": "651348",
            "influence_topics": [
                {
                    "url": "http://klout.com/topic/id/7516448513106795305",
                    "id": "7516448513106795305",
                    "name": "API",
                    "score": .99
                },
                {
                    "url": "http://klout.com/topic/id/7516448513106795306",
                    "id": "7516448513106795306",
                    "name": "basketball",
                    "score": .8
                }
            ],
            "interest_topics": [
                {
                    "url": "http://klout.com/topic/id/7516448513106795312",
                    "id": "7516448513106795312",
                    "name": "dogs",
                    "score": .55
                },
                {
                    "url": "http://klout.com/topic/id/7516448513106795306",
                    "id": "7516448513106795306",
                    "name": "basketball",
                    "score": .8
                }
            ]
        }
    }

Activity Streams Format:

{
    "gnip": {
        "klout_score": 27,
        "klout_profile": {
            "link": "http://klout.com/user/id/651348",
            "klout_user_id": "651348",
            "topics": [
                {
                    "link": "http://klout.com/topic/id/7516448513106795305",
                    "id": "7516448513106795305",
                    "displayName": "API",
                    "score": .99,
                    "topic_type": "influence"
                },
                {
                    "link": "http://klout.com/topic/id/7516448513106795306",
                    "id": "7516448513106795306",
                    "displayName": "basketball",
                    "score": .8,
                    "topic_type": "influence"
                },
                {
                    "link": "http://klout.com/topic/id/7516448513106795312",
                    "id": "7516448513106795312",
                    "displayName": "dogs",
                    "score": .55,
                    "topic_type": "interest"
                },
                {
                    "link": "http://klout.com/topic/id/7516448513106795306",
                    "id": "7516448513106795306",
                    "displayName": "basketball",
                    "score": .8,
                    "topic_type": "interest"
                }
            ]
        }
    }

FAQ

  1. What happens if a user has no Klout data?
    • For users without Klout data, our enrichment will not return any Klout information. Similarly, for users that do not have the maximum number of available topic data, we will return what is available.
  2. Do Gnip’s products support operators for Klout data?
    • No, at this time Gnip’s 2.0 products do not support any operators specific to Klout data.