Viralheat | Data API

Viralheat Pipeline

Getting Started

Social Trends (Free)

Profiles (Paid)

Statistics (Paid)

Data (Paid)

Data API Methods

Viralheat allows you to analyze social media like never before. Viralheat tracks hundreds of video sharing sites, twitter, blogs, social networks, groups and forums in real-time. Viralheat goes above and beyond monitoring by delivering analytics that help you optimize your outreach and engagement on social media platforms. Viralheat allows users to export all the filtered data via its API in real time. Viralheat data API is only available to users and requires an API Key for to access the data.

Available Methods

Method 1: List all Twitter Mentions
Method 2: List all Website Mentions
Method 3: List all Video Mentions
Method 4: List all Facebook Comments

Method 1: List all Twitter Mentions

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

api_key: the authenticated account key.
profile_id: id: unique id referencing the profile in the system.
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.
Twitter mentions: Return all the filtered twitter mentions for your profile.

Sample response:

			  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
 <profile>
   <id>321</id>
   <expression>Techcrunch</expression>
   <name></name>
 </profile>
 <tweets>
   <tweet>
     <message>Google?s New Music Search Will Be Getting A Boost From Your Favorite Bands http://bit.ly/18kChQ via (techcrunch)</message>
     <platform>Twitter</platform>
     <date_published>2009-11-03 02:31:38</date_published>
     <author>web2feed</author>
     <author_display_name>Michael Davis</author_display_name>
     <link>http://twitter.com/web2feed/statuses/5380739323</link>
     <profile_link>http://twitter.com/web2feed</profile_link>
     <profile_image_link>http://a1.twimg.com/profile_images/304998018/icon_128_normal.png</profile_image_link>
     <record_hash>30f8f2a3-83d3-33fa-bc2f-40a08d42c010</record_hash>
     <positive_score>0</positive_score>
     <negative_score>0</negative_score>
     <language>en</language>
     <tweet_contains_link>1</tweet_contains_link>
   </tweet>
 </tweets>
</entry>

Method 2: List all Website Mentions

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

api_key: the authenticated account key.
profile_id: id: unique id referencing the profile in the system.
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.
Website mentions: Return all the filtered website mentions for your profile.

Sample response:

			  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
 <profile>
   <id>321</id>
   <expression>Techcrunch</expression>
   <name></name>
 </profile>
 <sites>
   <site>
     <link>http://www.techcrunch.com/2009/11/02/google-says-chrome-browser-now-has-30-million-active-users/</link>
     <date_published>2009-11-03 02:34:40</date_published>
     <author>web2feed</author>
     <domain>www.techcrunch.com</domain>
     <country>United States</country>
     <country_code>US</country_code>
     <language>en</language>
     <site_title>Google&#8217;s Chrome Browser Is Now 30 Million Users Strong</site_title>
   </site>
 </sites>
</entry>

Method 3: List all Video Mentions

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

api_key: the authenticated account key.
profile_id: id: unique id referencing the profile in the system.
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.
Video mentions: Return all the filtered video mentions for your profile.

Sample response:

			  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>21</id>
    <expression>Coca Cola</expression>
    <name></name>
  </profile>
  <videos>
    <video>
      <title>X´n</title>
      <platform>YouTube</platform>
      <date_published>2009-10-30 00:00:00</date_published>
      <view_count>3</view_count>
      <url>http://www.youtube.com/watch?v=n2kUYpyfiBg</url>
    </video>
    <video>
      <title>COCA COLA + PAN + CANDA DRAY + AGUA = ?</title>
      <platform>YouTube</platform>
      <date_published>2009-10-30 00:00:00</date_published>
      <view_count>2</view_count>
      <url>http://www.youtube.com/watch?v=zzSjgilptMQ</url>
    </video>
  </videos>
</entry>

Method 4: List all Facebook Comments

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

api_key: the authenticated account key.
profile_id: id: unique id referencing the profile in the system.
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.
Facebook Comments: Return all the filtered Facebook mentions for your profile.

Sample response:

					  
<?xml version="1.0" encoding="UTF-8"?>
<entry>
  <profile>
    <id>21</id>
    <expression>Coca Cola</expression>
    <name></name>
  </profile>
  <facebook>
    <post>
      <comment>Coca Cola Village 2009!</comment>
      <date_published>Mon Feb 01 14:25:19 UTC 2010</date_published>
      <author>Coca Cola Village 2009!</author>
      <author_display_name>http://www.facebook.com/pages/Coca-Cola-Village-2009/112696675662</author_display_name>
    </post>
    <post>
      <comment>Coca-Cola Web</comment>
      <date_published>Mon Feb 01 11:37:02 UTC 2010</date_published>
      <author>Coca-Cola Web</author>
      <author_display_name>http://www.facebook.com/pages/Coca-Cola-Web/71194259418</author_display_name>
    </post>
    <post>
      <comment>Coca-Cola Web</comment>
      <date_published>Mon Feb 01 11:37:02 UTC 2010</date_published>
      <author>Coca-Cola Web</author>
      <author_display_name>http://www.facebook.com/pages/Coca-Cola-Web/71194259418</author_display_name>
    </post>
    <post>
      <comment>Coca-Cola Web</comment>
      <date_published>Mon Feb 01 11:37:02 UTC 2010</date_published>
      <author>Coca-Cola Web</author>
      <author_display_name>http://www.facebook.com/pages/Coca-Cola-Web/71194259418</author_display_name>
    </post>
  </facebook>
</entry>