NewsCloud Web Services
API Categories
Story Functions- storyAddToGroup
- storyCountComments
- storyEmail
- storyGetInfo
- storyGetPhotoUrlFromContentId
- storyGetPhotoUrlFromImageId
- storyGetRating
- storyGetUrl
- storyListComments
- storyListPhotos
- storyListRelated
- storyListTags
- storyPost
- storySetRating
storyAddToGroup
Add this story to a Group.
Arguments
contentid: the contentid for this story
idList: The comma separated list of relevant ids being asked for e.g. groups, tags, etc.
uid: the user id for this user
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyAddToGroup&contentid=74454&idList=3,7,9&uid=6524
storyCountComments
Count the comments for a story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyCountComments&contentid=74454
storyEmail
Email this story to a list of friends. Under special restriction.
Arguments
contentid: the contentid for this story
uid: the user id for this user
emailList: A list of email addresses delineated by spaces or commas.
subject: The subject for the user comment.
msg: The message to send.
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyEmail&contentid=74454&uid=1&emailList=test@test.com&subject=this is my subject&msg=this is my messageSpecial Restriction: Because this is an intensive or important write operation, this method is under tight restrictions to prevent spam and abuse. Please email us if you have a valid use for your Web site and would like your limit increased. In most cases, we will be glad to accomodate you.
storyGetInfo
Get title, description and other properties for a story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyGetInfo&contentid=74454
storyGetPhotoUrlFromContentId
Private function in apiNewsCloud.class.php. Returns the url to a photo for a story with this contentid.
Arguments
contentid: the contentid for this story
Usage:
$temp=$this->apiNewsCloud->storyGetPhotoUrlFromContentId($contentid)
<img src="'.$temp.'">
storyGetPhotoUrlFromImageId
Private function in apiNewsCloud.class.php. Returns the url to a photo from an imageid.
Arguments
imageid: The imageid for the photo.
Usage:
$temp=$this->apiNewsCloud->storyGetPhotoUrlFromImageId($imageid)
<img src="'.$temp.'">
storyGetRating
Get the vote summary for a story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyGetRating&contentid=74454
storyGetUrl
Constructs url to story with this contentid. Private function in apiNewsCloud.class.php.
Arguments
contentid: the contentid for this story
Usage:
$temp=$this->apiNewsCloud->storyGetUrl($contentid)
Link to <a href="'.$temp.'">Story headline</a>
storyListComments
Listst the comments for a story.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListComments&contentid=74454&startRow=0
storyListPhotos
List photos associated with this story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListPhotos&contentid=74454
storyListRelated
List stories related to this one.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListRelated&contentid=74454&startRow=0
storyListTags
List the tags for a story.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListTags&contentid=74454&startRow=0
storyPost
Post a story to NewsCloud. Requires account access. Under special restriction.
Arguments
uid: the user id for this user
storyUrl: The URL or Web page where the story is located.
title: The headline or title for the user post.
description: The body of the message for the user comment. Alternately, a description of a group.
tagList: a list of tags
imageUrl: The image URL where the photo is located.
media: A valid media type for the post e.g. text, audio, video, or journal
isTest: Used for testing APIs that write to the database. When isTest is true, nothing gets written to the database.
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyPost&uid=1&storyUrl=http://www.msnbc.msn.com/id/15190745/&title=North Korea Tests Nuke&description=Why are we in Iraq? You tell me...&tagList=North+Korea nuclear+test bush&imageUrl=http://msnbcmedia.msn.com/j/msnbc/Components/Video/061009/n_bush_nkorea_061009.300w.jpg&media=text&isTest=trueAccount Access: Because this method accesses a specific user account's private data, you either need to use the API key from the account of this user OR you must authenticate access to the user's account with userSignIn method before calling this function. Once signed in for this user's account, your session will last one hour.
Special Restriction: Because this is an intensive or important write operation, this method is under tight restrictions to prevent spam and abuse. Please email us if you have a valid use for your Web site and would like your limit increased. In most cases, we will be glad to accomodate you.
storySetRating
Set the user\'s rating for or against a story on NewsCloud. Requires account access.
Arguments
contentid: the contentid for this story
uid: the user id for this user
rating: The vote for or against a story e.g. 1 or -1
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storySetRating&rating=-1&contentid=74414&uid=1Account Access: Because this method accesses a specific user account's private data, you either need to use the API key from the account of this user OR you must authenticate access to the user's account with userSignIn method before calling this function. Once signed in for this user's account, your session will last one hour.
storyAddToGroup
Add this story to a Group.
Arguments
contentid: the contentid for this story
idList: The comma separated list of relevant ids being asked for e.g. groups, tags, etc.
uid: the user id for this user
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyAddToGroup&contentid=74454&idList=3,7,9&uid=6524storyCountComments
Count the comments for a story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyCountComments&contentid=74454storyEmail
Email this story to a list of friends. Under special restriction.
Arguments
contentid: the contentid for this story
uid: the user id for this user
emailList: A list of email addresses delineated by spaces or commas.
subject: The subject for the user comment.
msg: The message to send.
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyEmail&contentid=74454&uid=1&emailList=test@test.com&subject=this is my subject&msg=this is my messageSpecial Restriction: Because this is an intensive or important write operation, this method is under tight restrictions to prevent spam and abuse. Please email us if you have a valid use for your Web site and would like your limit increased. In most cases, we will be glad to accomodate you.
storyGetInfo
Get title, description and other properties for a story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyGetInfo&contentid=74454storyGetPhotoUrlFromContentId
Private function in apiNewsCloud.class.php. Returns the url to a photo for a story with this contentid.
Arguments
contentid: the contentid for this story
Usage:
$temp=$this->apiNewsCloud->storyGetPhotoUrlFromContentId($contentid)<img src="'.$temp.'">
storyGetPhotoUrlFromImageId
Private function in apiNewsCloud.class.php. Returns the url to a photo from an imageid.
Arguments
imageid: The imageid for the photo.
Usage:
$temp=$this->apiNewsCloud->storyGetPhotoUrlFromImageId($imageid)<img src="'.$temp.'">
storyGetRating
Get the vote summary for a story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyGetRating&contentid=74454storyGetUrl
Constructs url to story with this contentid. Private function in apiNewsCloud.class.php.
Arguments
contentid: the contentid for this story
Usage:
$temp=$this->apiNewsCloud->storyGetUrl($contentid)Link to <a href="'.$temp.'">Story headline</a>
storyListComments
Listst the comments for a story.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListComments&contentid=74454&startRow=0storyListPhotos
List photos associated with this story.
Arguments
contentid: the contentid for this story
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListPhotos&contentid=74454storyListRelated
List stories related to this one.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListRelated&contentid=74454&startRow=0storyListTags
List the tags for a story.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyListTags&contentid=74454&startRow=0storyPost
Post a story to NewsCloud. Requires account access. Under special restriction.
Arguments
uid: the user id for this user
storyUrl: The URL or Web page where the story is located.
title: The headline or title for the user post.
description: The body of the message for the user comment. Alternately, a description of a group.
tagList: a list of tags
imageUrl: The image URL where the photo is located.
media: A valid media type for the post e.g. text, audio, video, or journal
isTest: Used for testing APIs that write to the database. When isTest is true, nothing gets written to the database.
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storyPost&uid=1&storyUrl=http://www.msnbc.msn.com/id/15190745/&title=North Korea Tests Nuke&description=Why are we in Iraq? You tell me...&tagList=North+Korea nuclear+test bush&imageUrl=http://msnbcmedia.msn.com/j/msnbc/Components/Video/061009/n_bush_nkorea_061009.300w.jpg&media=text&isTest=trueAccount Access: Because this method accesses a specific user account's private data, you either need to use the API key from the account of this user OR you must authenticate access to the user's account with userSignIn method before calling this function. Once signed in for this user's account, your session will last one hour.
Special Restriction: Because this is an intensive or important write operation, this method is under tight restrictions to prevent spam and abuse. Please email us if you have a valid use for your Web site and would like your limit increased. In most cases, we will be glad to accomodate you.
storySetRating
Set the user\'s rating for or against a story on NewsCloud. Requires account access.
Arguments
contentid: the contentid for this story
uid: the user id for this user
rating: The vote for or against a story e.g. 1 or -1
REST Format:
http://api.newscloud.com/services/node.php?apikey=your-apikeyhere&method=storySetRating&rating=-1&contentid=74414&uid=1Account Access: Because this method accesses a specific user account's private data, you either need to use the API key from the account of this user OR you must authenticate access to the user's account with userSignIn method before calling this function. Once signed in for this user's account, your session will last one hour.
