Kred RT Influence

Returns @names that have posted within the time range specified ranked by those with the most amount of total RTs. Search functions include a [term] a user has mentioned (keyword, phrase, #hashtag, url), [bio] term (keyword, #hashtag, url), and/or [location] (city, state, country) over a specified timeframe.

Examples:
term=bio:mommy AND bio:blogger AND pepsi
term=none bio:CEO AND state:CA
term=nike AND bio:runner AND city:san_francisco

URL: http://api.peoplebrowsr.com/kredretweetinfluence?

Request - Required Parameters

  • app_id (STRING) - Eight Digit ID [ex: 84d8620b]
  • app_key (STRING) - Thirty-two digit key [ex: 281014ad8b0fba5adcc88fac7d79999c]
  • Post app registration, your app id and key can be viewed by going to https://developer.peoplebrowsr.com/admin/applications and clicking "view"

Time Period - Only two of three of these need to be used in a string. First & Last, First & Count, or Last & Count. Last & Count will return results the easiest.

  • first (STRING) - Defines the start of the time period. If January 1 2012 to February 21, 2012 was the specification required, start with specifying the the first time point with first=2011-01-01. Alternatively, say the specification was between yesterday and today.
    • Example(s): first=2011-01-01 first=1323466328 or first=yesterday
  • last (STRING) - Defines the end of a time period. To continue the example above, if the date range specified is January 1, 2012 to February 21, 2011, specify last=2011-02-21. Alternatively say the time period you always wanted to measure was today. One could specify last=today, and then use count to specify 14, 30, up to 1000 days back relative to the time range enabled for the account on the API.
    • Example: last=2012-02-21 or last=1318195928 OR last=yesterday OR last=today
  • count (STRING) - Count is used as a period proxy to specified time periods. The standard time period is a day, so using count, you would specify the last 30, 60, 90, 100, to 1000 days by specifying last=today & count=30 (or another period length).
    • Example: count=1 OR 10 OR 100 OR 1000 to specify the time period backward or forward
  • source (STRING) - source=twitter
  • term (STRING) - Parameter description (values: @Name, Keyword, Multiple Keywords, #Hashtag, Phrase, or Post) - See Appendix 1: Term Structures for all terms
  • Request - Option Parameters

    • period (STRING) - Integer of the number of seconds that a period constitutes if "count" is specified rather than a start/end date.
      • Default setting: period=86400 (24 hours x 60 minutes x 60 seconds) or one Day
        • Day: Count=30 (30 days)
          • Example: &last=yesterday&count=30 - Specifies chart or histogram to return 30 days (periods) of data with reference to default period setting
        • Hour: Specify period=3600 (60 minutes x 60 seconds) & Count=24 (hours)
          • Example date setting: &last=2012-02-21&count=24&period=3600 - Returns the data per hour for the 24 hours backward
    • limit (STRING)- Limit search results to the specified number. Limit=20 will only return 20 data points and can be used in histograms or charts.
    • number (STRING) - Specifies number of items in non-histogram queries. If the parameter &number=10, the query will only return 10 data points.
    • reverse (STRING) - When set to reverse=true, this will reverse the order of the histograms, charts.

    Request - Sample URL

    http://api.peoplebrowsr.com/kredretweetinfluence?last=yesterday&count=10&source=twitter&term=Pepsi&app_id=84d8620b&app_key=281014ad8b0fba5adcc88fac7d79999c
    
    1. avatar_url (STRING) - Link to avatar url
    2. followers (NUMERIC)- Follower count from when @name mentioned the term
    3. following (NUMERIC)- Following count from when @name mentioned the term
    4. id (NAME) - @[name]
    5. influence (NUMERIC)- Global Kred Influence Score
    6. Name (NAME) - First and Last Name of User
    7. numeric_id (NUMBERIC) - Unique Twitter ID of User
    8. outreach (NUMERIC)- Global Kred Outreach Level
    9. status (STRING) - The status of your request (values: submitted, processing, waiting (rarely, happens with heavy loads to extended date ranges), complete)

    Sample Response

    
    {
      "data": [
        {
          "avatar": "http://a0.twimg.com/profile_images/1865369165/335423370_normal.jpg",
          "followers": 11421342,
          "following": 1128,
          "id": "NICKIMINAJ",
          "influence": 997,
          "name": "Nicki Minaj",
          "numeric_id": 35787166,
          "outreach": 5
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/2203039907/image_normal.jpg",
          "followers": 582606,
          "following": 183,
          "id": "itsChuckie",
          "influence": 994,
          "name": "itsChuckie\u272a ",
          "numeric_id": 262869742,
          "outreach": 8
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/2177296198/by_gab_1alguem_normal.jpg",
          "followers": 944395,
          "following": 68,
          "id": "girlversos",
          "influence": 989,
          "name": "girlversos \u2655",
          "numeric_id": 189534066,
          "outreach": 9
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/2188577128/bob_normal.gif",
          "followers": 228560,
          "following": 68,
          "id": "MijoDeRir",
          "influence": 982,
          "name": "Mijo De Rir \u221e",
          "numeric_id": 262519794,
          "outreach": 9
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/1830722846/RR-LOGO2_normal.jpg",
          "followers": 17356,
          "following": 1161,
          "id": "RetroReto",
          "influence": 969,
          "name": "RetroReto",
          "numeric_id": 325765217,
          "outreach": 9
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/1343143408/twitter_normal.jpg",
          "followers": 145384,
          "following": 1,
          "id": "NigeriaNewsdesk",
          "influence": 960,
          "name": "Nigeria Newsdesk",
          "numeric_id": 91316071,
          "outreach": 5
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/2156717733/image_normal.jpg",
          "followers": 146447,
          "following": 204,
          "id": "adamirigoyen",
          "influence": 959,
          "name": "Adam Irigoyen",
          "numeric_id": 178462340,
          "outreach": 7
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/2164853228/500x500_fb_normal.gif",
          "followers": 300188,
          "following": 272,
          "id": "USATODAY",
          "influence": 955,
          "name": "USA TODAY",
          "numeric_id": 15754281,
          "outreach": 4
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/1769643466/258844_104131489680984_104118713015595_32268_721285_o__1__normal.jpeg",
          "followers": 577233,
          "following": 89,
          "id": "YourAnonNews",
          "influence": 954,
          "name": "Anonymous",
          "numeric_id": 279390084,
          "outreach": 7
        },
        {
          "avatar": "http://a0.twimg.com/profile_images/866556637/teatime__normal.JPG",
          "followers": 716375,
          "following": 827,
          "id": "pattonoswalt",
          "influence": 953,
          "name": "Patton Oswalt",
          "numeric_id": 139162440,
          "outreach": 6
        }
      ],
      "id": "999-d42f53dc5995a488fb05040c3ec0f46f",
      "request": {
        "app_id": ********",
        "app_key": "******7225e53259bad3325e0d622667",
        "count": 10,
        "external": true,
        "last": 1336867200,
        "name": "kredretweetinfluence",
        "source": "twitter",
        "term": "pepsi"
      },
      "status": "complete"
    
    Sample Code Repurposed from Kred Influence - Kred RT Influence coming soon!

    PHP Code Sample

    Python Code Sample

    Ruby Code Sample