Get reactions for URL

GET http://api.contextvoice.com/1.2/reactions

Parameters:

  • url - the final URL, after all redirects (required)
  • since - retrieve all the reactions that are newer than this timestamp. the 'created_at' field (which is the date when the reaction was introduced in our system) is used when ordering the reactions (optional)
  • include[generator] - include only the reactions from the specified platforms(optional): twitter, friendfeed, digg, wordpress, blogger, typepad, disqus, flickr, picasa, youtube, vimeo, delicious, reddit, hackernews, mixx, stumbleupon, nytimes, slashdot, yahoobuzz, identica, propeller
  • exclude[generator] - exclude the reactions from the specified platforms(optional): twitter, friendfeed, digg, wordpress, blogger, typepad, disqus, flickr, picasa, youtube, vimeo, delicious, reddit, hackernews, mixx, stumbleupon, nytimes, slashdot, yahoobuzz, identica, propeller
  • filter=remove-retweets - exclude the reactions from Twitter that repeat/quote someone's tweet regarding the current conversation
  • filter=remove-similar - exclude the reactions that have a similar content
  • threaded=true - return the threaded conversation (retwitts will be treated as children of the original twitt)
  • order - asc, desc (optional) - order the reactions asc/desc using the 'created_at' field
  • page - start from the specific page in the result set
  • perpage - how many reactions will be included per page (default: 25; max: 100)
  • apikey - your API key (required - get one now)

Response

Parameter Description Type/Values Always
count total number of reactions non-negative integer yes
page current page of the result set non-negative integer yes
perpage number of results per page integer (1-100, default 25) yes
id id that uniquely identifies the reaction in our system string (32 chars) yes
url reaction initial url string yes
created_at unix timestamp when the reactions was added in our system integer yes
published unix timestamp when the reaction was created integer yes
generator platform where the reaction was created string: wordpress | blogger | hostedblogger | movabletype | typepad | hostedtypepad | nytimes | youtube | flickr | picasa | imdb | friendfeed | twitter | digg | hackernews | slashdot | reddit | delicious | stumbleupon | mixx | identica | propeller
 yes
type reaction type string: story.comment.singular | photo.comment.singular | video.comment.singular | video.response.singular | comment.singular | resource.singular | blog.post.comment.singular yes
name reaction author name string yes
image reaction author image string no
title reaction title string yes
content reaction content string yes

Sample requests:

http://api.contextvoice.com/1.2/reactions/?url=http://www.ubervu.com&apikey=123456

http://api.contextvoice.com/1.2/reactions/?url=http://mashable.com/2009/03/04/social-media-comments/&apikey=123456&exclude[generator]=digg,wordpress

http://api.contextvoice.com/1.2/reactions/?url=http://www.avc.com/a_vc/2009/04/when-you-are-a-public-company-without-being-public.html&apikey=123456&since=1239891364&include[generator]=twitter,friendfeed,digg

http://api.contextvoice.com/1.2/reactions/?filter=remove-retweets&url=http://mashable.com/2009/05/21/photos-deleted-facebook/&apikey=123456

JSONP support

If you want to be able to make crossdomain AJAX requests, you can use JSONP. All you need to do is to append "&callback=?" at the end of the request.

Example: http://api.contextvoice.com/1.2/reactions/?url=http://www.ubervu.com&apikey=123456&callback=?

Sample responses

The XML response should look like this:

And the JSON response should look like this:

Sample code (Python)

version 5 as of 1 week ago by ubervu Admin

Comments

Please sign in to post a comment.