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
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.
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.
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
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
storyListTags
List the tags for a story.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
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.
Account 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
Account 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
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.
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.
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
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
storyListTags
List the tags for a story.
Arguments
contentid: the contentid for this story
startRow: the start row to begin the query
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.
Account 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
Account 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.
