Sign_up Login
 
Viralheat | Social Trends API
Pipeline

Social Trends API Methods

Viralheat is a social media measurement platform that allows you to track topics, brands, television shows, and movies across many different mediums all in one place using the best technology. The users of Viralheat choose to share a subset of their profiles with the world. Social Trends API is freely available to everyone.
Method 1: List all Profiles in Social trends
URL: http://www.viralheat.com/api/social_trends/profiles?page_number=1
Format: XML
HTTP Method: GET
Requires Authentication: No
Parameters:
page_number (optional): Specifies the page of social trends profile to retrieve.

Return Values:
id: unique id referencing a profile in the system
name: name of the profile.
expression: search expression used for the profile.
location: Location to search (if provided by the user)
radius: radius of search - associated with the location.
created_at: date at which the profile was created.
public: Wether the profile is publicly available for social trends
category: Category of the profile - classified by the user who made the profile.
Categories in Viralheat: General, Brand, Television, Movies, Music, Person, Sports, Politics, Topic.

Sample response: 
			  
<?xml version="1.0" encoding="UTF-8"?>
<profiles>
  <profile>
    <id>21</id>
    <name>Coca Cola</name>
    <expression>Coca Cola</expression>
    <location></location>
    <radius></radius>
    <created_at>2009-04-18 21:58:17 UTC</created_at>
    <public>1</public>
    <category>General</category>
  </profile>
</profiles>
Method 2: List Social trends profile stats
URL: http://www.viralheat.com/api/social_trends/stats?profile_id=192
Format: XML
HTTP Method: GET
Requires Authentication: No
Parameters:
profile_id: unique id referencing the profile in Social trends.

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: All the vital twitter stats for the profile.
Facebook stats: All the vital Facebook page related stats for the profile.
Website stats: vital statistics for blogs and websites for the profile.
Video stats: vital statistics for video sharing sites for the profile.

Sample Response: 
			  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>197</id>
    <name></name>
    <expression>Playstation</expression>
  </profile>
  <twitter_stats>
    <total_tweets_seven_days>9985</total_tweets_seven_days>
    <average_tweets>1426.42857142857</average_tweets>
    <total_tweets_today>421</total_tweets_today>
    <latest_tweet>MICROSOFT XBOX 360 20 GB PRO SYSTEM!  HDMI &amp; FALCON! - US $149.99 (0 Bid) End Date: Tuesday Nov-03-2009 16:01:03 PST http://su.pr/5iy355</latest_tweet>
    <latest_tweet_url>*</latest_tweet_url>
    <popular_author>Adgall99</popular_author>
  </twitter_stats>
  <facebook_stats>
    <total_posts_seven_days>268</total_posts_seven_days>
    <average_posts>38.2857142857143</average_posts>
    <total_posts_today>0</total_posts_today>
    <popular_page>Rita Schiano</popular_page>
    <popular_page_url>http://www.facebook.com/pages/Rita-Schiano/53584624487</popular_page_url>
  </facebook_stats>
  <website_stats>
    <total_sites_seven_days>5388</total_sites_seven_days>
    <average_sites>769.714285714286</average_sites>
    <total_sites_today>218</total_sites_today>
    <top_domain>http://twitter.com</top_domain>
    <top_url>http://news.google.com/news?shouldnt_happen=bad_redirect</top_url>
  </website_stats>
  <video_stats>
    <total_videos_seven_days>394</total_videos_seven_days>
    <total_video_views>344274</total_video_views>
    <hottest_video>How To Download Movies onto The Playstation 3</hottest_video>
    <hottest_video_url>http://www.veoh.com/browse/videos/category/technology_and_gaming/watch/v19299002AFwsrG48</hottest_video_url>
    <hottest_video_platform>YouTube</hottest_video_platform>
  </video_stats>
</entry>