#Hashtag Cloud

The top hashtags in posts mentioning the term, ordered by frequency.

URL: http://api.peoplebrowsr.com/hashtagcloud

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 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: &first=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: &first=1323468000&count=24&period=3600 - Returns 1 day of data by hour
• 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/hashtagcloud?last=yesterday&count=30&source=twitter&term=Pepsi&app_id=12345&app_key=281014ad8b0fba5adcc88fac7d79999c

Response

Responses return 100 data points with JSON format.

Response - Fields

1. #hashtag (STRING) - Returns #hashtags within tweets of term specified.
2. frequency (STRING) - Frequency of #hashtags mentioned relative to time period specified.
3. status (STRING) - The status of your request (values: submitted, processing, complete)

Sample Response

{ "data": [ [ "#pepsi", 8958 ], [ "#pepsirefresh", 7872 ], [ "#podesermoraless", 2531 ], [ "#pepsisoundoff", 2044 ], [ "#xfactor", 1640 ], [ "#cocacola", 776 ], [ "#5palabrasquejoden", 763 ], [ "#pepsiicon", 684 ], [ "#coke", 596 ], [ "#bengals", 558 ], [ "#comoteexplico", 550 ], [ "#firstworldpains", 547 ], [ "#drinkup", 524 ], [ "#winning", 427 ], [ "#princessprobz", 402 ], [ "#pepsirefresh@pepsi", 371 ], [ "#coca-cola", 369 ], [ "#nevertrustagirl", 338 ], [ "#20factsaboutme", 335 ], [ "#theyneed2bringback", 302 ], [ "#malascombinaciones", 301 ], [ "#firstjob", 295 ], [ "#fb", 286 ], [ "#jobs", 252 ], [ "#friendship", 252 ], [ "#non-negotiable", 245 ], [ "#loesoetweets", 243 ], [ "#ff", 242 ], [ "#tahrir", 237 ], [ "#twitfakta", 233 ], [ "#marketing", 219 ], [ "#tgif", 216 ], [ "#marcasquenostocaron", 209 ], [ "#love", 196 ], [ "#wtf", 195 ], [ "#imaddicted", 194 ], [ "#fail", 182 ], [ "#fact", 180 ], [ "#sorteio", 180 ], [ "#random", 167 ], [ "#curiosidade", 163 ], [ "#nuggets", 160 ], [ "#getmoneyout", 157 ], [ "#trendycontroversies", 150 ], [ "#withoutyou", 141 ], [ "#vilekyle", 140 ], [ "#commercial", 137 ], [ "#max", 137 ], [ "#facebook", 136 ], [ "#pepsican", 134 ], [ "#oomf", 131 ], [ "#hurts", 130 ], [ "#photos", 129 ], [ "#lol", 129 ], [ "#mecon", 127 ], [ "#pepi", 125 ], [ "#thingsblackpeoplesayinarguments", 125 ], [ "#askniall", 116 ], [ "#auc", 116 ], [ "#teampepsi", 115 ], [ "#teamfollowback", 114 ], [ "#coca", 114 ], [ "#letsbringback", 114 ], [ "#addicted", 113 ], [ "#rt", 113 ], [ "#comoreconoceraunnaco", 110 ], [ "#grammynoms", 108 ], [ "#1", 108 ], [ "#himandher", 106 ], [ "#momentsicanneverforget", 104 ], [ "#teamcoke", 97 ], [ "#midnightsnack", 92 ], [ "#yum", 92 ], [ "#justsaying", 92 ], [ "#lasbibliotecasmolan", 90 ], [ "#egypt", 89 ], [ "#preguntaleaamlo", 89 ], [ "#cosasabsurdas", 88 ], [ "#publicidad", 87 ], [ "#llegopepsiaparaguay", 86 ], [ "#thingsthirstypeopledo", 85 ], [ "#followmemtv", 84 ], [ "#swag", 83 ], [ "#butthatsjustme", 82 ], [ "#simpleplan", 80 ], [ "#firstworldproblems", 80 ], [ "#greycup", 78 ], [ "#ravens", 78 ], [ "#fattweet", 77 ], [ "#fml", 76 ], [ "#minhainfancia", 75 ], [ "#2", 73 ], [ "#destacada", 69 ], [ "#pepsimusica", 69 ], [ "#whenigoto7eleven", 69 ], [ "#nh7", 68 ], [ "#smh", 67 ], [ "#avs", 66 ], [ "#udechile", 66 ], [ "#batmitzvahgames", 66 ] ], "id": "999-5a4d80a3c7268c548caf600ac55c0e84", "request": { "app_id": "2476ec6a", "app_key": "8ede04eb39412a3a4e346591bd112e27", "count": 30, "external": true, "last": 1323475200, "name": "hashtagcloud", "source": "twitter", "term": "pepsi" }, "status": "complete" }