NewsGator Online API

Feed Operations

XmlElement GetNews(feedId, locationName, token, unreadOnly)

This method returns an RSS document for the given feed. This is the equivalent of referencing the syncXmlUrl attribute of the OPML outline returned from GetSubscriptions, but is provided in SOAP form for user agents that prefer to use SOAP.

Parameters
feedId
The NewsGator ID for the feed to retrieve news.
locationName
The name of the location retrieving news.
token
A sync token returned from an earlier GetNews call.
unreadOnly
True if you want to retrieve unread posts only, false to return all current content in the feed.

XmlElement GetFeedContent(feedId, locationName, token)

This method returns an RSS document for the given feed. This is the equivalent of referencing the syncXmlUrl attribute of the OPML outline returned from GetSubscriptions, but is provided in SOAP form for user agents that prefer to use SOAP. This method returns the same content as GetNews, but without user metadata (read states and ratings).

Parameters
feedId
The NewsGator ID for the feed to retrieve news.
locationId
The id of the location retrieving news.
token
A sync token returned from an earlier GetFeedContent call.

void MarkRead(feedId, locationName, read, token)

Sets all the posts in the specified feed to be read or unread, based on a parameter.

Parameters
feedId
The NewsGator ID for the feed to be marked read.
locationName
The name of the location performing the operation.
read
Set to true, marking a feed unread is not currently supported.
token
A sync token returned from an earlier GetNews call.

void MarkFeedsRead(feedIds, locationName)

Sets all the posts in the specified feeds to be read.

Parameters
feedIds
A list of NewsGator IDs for the feeds to mark read.
locationName
The name of the location performing the operation.

FeedInfoSummary[] GetFeedInfoSummaryFromXmlUrl(xmlurls)

Returns a list of FeedInfoSummary structures, one for each of the submitted urls. The fields in this structure are

FeedID
The NewsGator ID for the feed.
Title
The feed's title as set by the publisher, or custom title as set by the user
Description
A description of the feed as set by the publisher.
XmlUrl
The url where the feed is retrieved from
HtmlLink
An HTML link for the feed, as set by the publisher.
SubscriptionCount
The number of NewsGator users subscribed to this feed.

Parameters
xmlurls
A list of strings containing the xmlurl of each feed that you would like to retrieve a summary for.

SOAP Endpoint


Copyright © 2003-2009  NewsGator Technologies, Inc.  All Rights Reserved.
USA   FRA   GBR   BEL   ESP   ITA   DEU   NLD   

Microsoft Gold Certified Partner