Kred Influence
Returns @names that have posted most recently that have matched what is specified within the term ranked by Kred Influence Score. 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/kredinfluence?
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
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/kredinfluence?last=today&count=10&source=twitter&term=Pepsi&app_id=84d8620b&app_key=281014ad8b0fba5adcc88fac7d79999c
- avatar_url (STRING) - Link to avatar url
- id (STRING) - @[name]
- followers (NUMERIC)- Follower count from when @name mentioned the term
- following (NUMERIC)- Following count from when @name mentioned the term
- influence (NUMERIC)- Global Kred Influence Score
- outreach (NUMERIC)- Global Kred Outreach Level
- 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/1766547928/dit_newlogo_1_normal.jpg",
"followers": 1396835,
"following": 80,
"id": "damnitstrue",
"influence": 1000,
"numeric_id": 66714703,
"outreach": 6
},
{
"avatar": "http://a0.twimg.com/profile_images/1662896659/mr_catra_normal.jpg",
"followers": 600502,
"following": 138,
"id": "Catrafrases",
"influence": 998,
"numeric_id": 236265286,
"outreach": 7
},
{
"avatar": "http://a0.twimg.com/profile_images/1859512476/ohteenquotesICON_normal.jpg",
"followers": 1048614,
"following": 2140,
"id": "ohteenquotes",
"influence": 998,
"numeric_id": 89423854,
"outreach": 7
},
{
"avatar": "http://a0.twimg.com/profile_images/1824925477/iSpeakComedy_avatar_for_Twitter_normal.jpg",
"followers": 653057,
"following": 94,
"id": "iSpeakComedy",
"influence": 995,
"numeric_id": 255168531,
"outreach": 8
},
{
"avatar": "http://a0.twimg.com/profile_images/1861459622/fatooooooooooooooooooooooooooooos-juventude_normal.gif",
"followers": 445239,
"following": 74,
"id": "FatosJuventude",
"influence": 994,
"numeric_id": 94545371,
"outreach": 9
},
{
"avatar": "http://a0.twimg.com/profile_images/1705605724/01_metro_blackberry_01_normal.jpg",
"followers": 1673493,
"following": 67,
"id": "Metro_TV",
"influence": 993,
"numeric_id": 57261519,
"outreach": 5
},
{
"avatar": "http://a0.twimg.com/profile_images/1743751362/AvatarT_normal.jpg",
"followers": 999791,
"following": 51,
"id": "la_patilla",
"influence": 992,
"numeric_id": 124172948,
"outreach": 5
},
{
"avatar": "http://a0.twimg.com/profile_images/1876766608/1328904623882_normal.png",
"followers": 483753,
"following": 41,
"id": "SuperChiste",
"influence": 990,
"numeric_id": 148581410,
"outreach": 6
},
{
"avatar": "http://a0.twimg.com/profile_images/1185887083/breakingnews_normal.png",
"followers": 3752761,
"following": 517,
"id": "BreakingNews",
"influence": 990,
"numeric_id": 6017542,
"outreach": 7
},
{
"avatar": "http://a0.twimg.com/profile_images/1797160912/HP_Twitter_avatar_128x128_normal.png",
"followers": 1659027,
"following": 4824,
"id": "HuffingtonPost",
"influence": 990,
"numeric_id": 14511951,
"outreach": 6
}
],
"id": "999-5d4e8d2de2bae789cfe4055a17b0a485",
"request": {
"app_id": "***ca2b5",
"app_key": "******a29958d5f29a3624c7845f20ab",
"count": 10,
"external": true,
"last": 1331596800,
"name": "kredinfluence",
"source": "twitter",
"term": "pepsi"
},
"status": "complete"
PHP Code Sample
Python Code Sample
Ruby Code Sample
We are a High Tech Social Analytics Company with a passion for marketing.
Terms & Conditions
© 2012 PeopleBrowsr
© 2012 PeopleBrowsr