Viralheat | Statistics API

Viralheat Pipeline

Getting Started

Social Trends (Free)

Profiles (Paid)

Statistics (Paid)

Data (Paid)

Trends and Statistics API Methods

Viralheat goes above and beyond monitoring by delivering analytics that help you optimize your outreach and engagement on social media platforms. Viralheat delivers unparalleled real-time stream of mentions for your brands, products or topics of interest so you can perform critical analysis and identify opportunities. From key influencers to traffic trends and sentiment, Viralheat users can export all the statistics generated by our system in real-time. Viralheat statistics API is only available to users and requires an API Key for to access the data.

Available Methods

Method 1: Twitter Stats
Method 2: Twitter Trends
Method 3: Website Stats
Method 4: Website Trends
Method 5: Video Stats
Method 6: Video Trends
Method 7: Facebook Stats
Method 8: Facebook Trends

Method 1: Twitter Stats

URL: http://www.viralheat.com/api/twitter/stats?profile_id=5525&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

profile_id: id: unique id referencing the profile in the system.
api_key: the authenticated account key.
days: the total number of days for which the aggregated stats are computed.
Note: Stats are computed in real time and you can export it daily / weekly or monthly. Valid values are 1,7,30 for the days parameter.

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Twitter stats: Detailed twitter stats for the profile.

Sample response:

				  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>5525</id>
    <expression>starbucks (via | coffee) -bean -"coffee maker"</expression>
    <name>Starbucks</name>
  </profile>
  <stats>
    <total_tweets_seven_days>4966</total_tweets_seven_days>
    <average_daily_tweets>709.43</average_daily_tweets>
    <total_tweets_today>330</total_tweets_today>
    <active_day_of_week>Monday</active_day_of_week>
    <total_unique_authors>4385</total_unique_authors>
    <popular_author>Freisher</popular_author>
    <positive_sentiment>0.00</positive_sentiment>
    <negative_sentiment>0.00</negative_sentiment>
    <neutral_sentiment>100.00</neutral_sentiment>
    <total_links>1047</total_links>
    <percent_links>21.08</percent_links>
    <total_retweets>279</total_retweets>
    <percent_retweets>5.62</percent_retweets>
    <top_language>en</top_language>
    <impact>657936</impact>
    <top_author_by_authority>foxnews</top_author_by_authority>
    <top_author_by_authority_by_followers>108251</top_author_by_authority_by_followers>
  </stats>
</entry>

Method 2: Twitter Trends

URL: http://www.viralheat.com/api/twitter/seven_day_trend?profile_id=5989&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

profile_id: id: unique id referencing the profile in the system.
api_key: the authenticated account key.
days: the total number of days for which the traffic trends are desired.
Note: Valid values are 1,7,30 for the days parameter.

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Twitter trends: Twitter traffic trend for the profile.

Sample response:

				  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>21</id>
    <expression>Coca Cola</expression>
    <name></name>
  </profile>
  <trends>
    <trend>
      <date>2010-01-18</date>
      <tweets>1589</tweets>
    </trend>
    <trend>
      <date>2010-01-19</date>
      <tweets>3268</tweets>
    </trend>
    <trend>
      <date>2010-01-20</date>
      <tweets>1560</tweets>
    </trend>
    <trend>
      <date>2010-01-21</date>
      <tweets>3456</tweets>
    </trend>
    <trend>
      <date>2010-01-22</date>
      <tweets>199</tweets>
    </trend>
    <trend>
      <date>2010-01-23</date>
      <tweets>1174</tweets>
    </trend>
    <trend>
      <date>2010-01-24</date>
      <tweets>0</tweets>
    </trend>
  </trends>
</entry>

Method 3: Website Stats

URL: http://www.viralheat.com/api/website/stats?profile_id=5525&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Website stats: Detailed website stats for the profile.

Sample response:

				  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
 <profile>
   <id>5525</id>
   <expression>starbucks (via | coffee) -bean -"coffee maker"</profile_expression>
   <name>Starbucks</name>
 </profile>
 <stats>
   <total_sites_seven_days>614</total_sites_seven_days>
   <average_daily_sites>87.71</average_daily_sites>
   <total_sites_today>46</total_sites_today>
   <top_country>United States</top_country>
   <total_sites_top_country>1</total_sites_top_country>
   <top_language>Sv</top_language>
   <total_sites_top_language>1</total_sites_top_language>
   <total_authors>503</total_authors>
   <top_author>Starbucksblogs</top_author>
   <total_sites_top_author>27</total_sites_top_author>
   <top_domain>twitpic.com</top_domain>
   <total_mentions_top_domain>118</total_mentions_top_domain>
   <top_domain_url>http://twitpic.com</top_domain_url>
   <top_link>Oak Park Starbucks Closes, Old Soul Coffee To Open - cbs13.com</top_link>
   <total_mentions_top_link>6</total_mentions_top_link>
   <top_link_url>http://cbs13.com/local/Oak.Park.Starbucks.2.1258236.html</top_link_url>
 </stats>
</entry>

Method 4: Website Trends

URL: http://www.viralheat.com/api/website/trend?profile_id=321&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Website trends: Seven day blog and websites traffic trend for the profile.

Sample response:

				  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>21</id>
    <expression>Coca Cola</expression>
    <name></name>
  </profile>
  <trends>
    <trend>
      <date>2010-01-18</date>
      <sites>379</sites>
    </trend>
    <trend>
      <date>2010-01-19</date>
      <sites>683</sites>
    </trend>
    <trend>
      <date>2010-01-20</date>
      <sites>216</sites>
    </trend>
    <trend>
      <date>2010-01-21</date>
      <sites>673</sites>
    </trend>
    <trend>
      <date>2010-01-22</date>
      <sites>44</sites>
    </trend>
    <trend>
      <date>2010-01-23</date>
      <sites>204</sites>
    </trend>
    <trend>
      <date>2010-01-24</date>
      <sites>0</sites>
    </trend>
  </trends>
</entry>

Method 5: Video Stats

URL: http://www.viralheat.com/api/video/stats?profile_id=321&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Video stats: Detailed Video stats for the profile.

Sample response:

				  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>321</id>
    <expression>Techcrunch</expression>
    <name></name>
  </profile>
  <stats>
    <total_videos_seven_days>16</total_videos_seven_days>
    <total_videos_today>2</total_videos_today>
    <average_weekly_videos>2.29</average_weekly_videos>
    <total_views>9971</total_views>
    <hottest_video_title>Exclusive TC Demo of Lala's iPhone app</hottest_video_title>
    <hottest_video_url>http://www.youtube.com/watch?v=W7ZSx6oDf3Q</hottest_video_url>
    <hottest_platform>YouTube</hottest_platform>
    <precent_daily_change>0</precent_daily_change>
  </stats>
</entry>

Method 6: Video Trends

URL: http://www.viralheat.com/api/video/seven_day_trend?profile_id=321&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Video trends: Video traffic trend for the profile.

Sample response:

				  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>21</id>
    <expression>Coca Cola</expression>
    <name></name>
  </profile>
  <trends>
    <trend>
      <date>2010-01-18</date>
      <videos>56</videos>
    </trend>
    <trend>
      <date>2010-01-19</date>
      <videos>42</videos>
    </trend>
    <trend>
      <date>2010-01-20</date>
      <videos>5</videos>
    </trend>
    <trend>
      <date>2010-01-21</date>
      <videos>0</videos>
    </trend>
    <trend>
      <date>2010-01-22</date>
      <videos>0</videos>
    </trend>
    <trend>
      <date>2010-01-23</date>
      <videos>0</videos>
    </trend>
    <trend>
      <date>2010-01-24</date>
      <videos>0</videos>
    </trend>
  </trends>
</entry>

Method 7: Facebook Stats

URL: http://www.viralheat.com/api/facebook/stats?profile_id=321&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Facebook stats: Detailed Facebook stats for the profile.

Sample response:

						  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>21</id>
    <expression>Coca Cola</expression>
    <name></name>
  </profile>
  <stats>
    <total_facebook_comments>1</total_facebook_comments>
    <average_facebook_comments>1.00</average_facebook_comments>
    <total_unique_authors>1</total_unique_authors>
    <active_day_of_week>--</active_day_of_week>
    <total_fans>1</total_fans>
    <total_pages>1</total_pages>
    <average_fans_per_page>1</average_fans_per_page>
    <positive_sentiment>0.0</positive_sentiment>
    <negative_sentiment>0.0</negative_sentiment>
    <neutral_sentiment>100.0</neutral_sentiment>
    <top_page_by_fans_title>MIP</top_page_by_fans_title>
    <top_page_by_fans_url>http://www.facebook.com/pages/MIP/62155277047</top_page_by_fans_url>
    <top_page_fans>1396</top_page_fans>
    <top_page_by_posts_title>MIP</top_page_by_posts_title>
    <top_page_by_posts_url>http://www.facebook.com/pages/MIP/62155277047</top_page_by_posts_url>
    <top_page_posts>0</top_page_posts>
  </stats>
</entry>

Method 8: Facebook Trends

URL: http://www.viralheat.com/api/facebook/trend?profile_id=321&days=7&api_key=[*** your api key ***]
Format: XML
HTTP Method: GET
Requires Authentication: Yes
Parameters:

Return Values:

id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
Facebook trends: Facebook traffic trend for the profile.

Sample response:

								  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>21</id>
    <expression>Coca Cola</expression>
    <name></name>
  </profile>
  <trends>
    <trend>
      <date>2010-01-18</date>
      <facebook_comments>0</facebook_comments>
    </trend>
    <trend>
      <date>2010-01-19</date>
      <facebook_comments>0</facebook_comments>
    </trend>
    <trend>
      <date>2010-01-20</date>
      <facebook_comments>0</facebook_comments>
    </trend>
    <trend>
      <date>2010-01-21</date>
      <facebook_comments>10</facebook_comments>
    </trend>
    <trend>
      <date>2010-01-22</date>
      <facebook_comments>0</facebook_comments>
    </trend>
    <trend>
      <date>2010-01-23</date>
      <facebook_comments>0</facebook_comments>
    </trend>
    <trend>
      <date>2010-01-24</date>
      <facebook_comments>1</facebook_comments>
    </trend>
  </trends>
</entry>