Go to Feed ID:	» Log In » Register » Suggest » Feeds » News » Podcasts » Tags » Pings » Documents » XML » Web Services » Categories » Statistics » Help » Site Map » About

Formats

The Syndic8 feed list is available in the following formats:

Format		URL
OCS		http://www.syndic8.com/genfeed.php?Format=ocs
OPML		http://www.syndic8.com/genfeed.php?Format=opml
RSS		http://www.syndic8.com/genfeed.php?Format=rss

Data Sources

The genfeed.php script can use any one of the following sources for the list of feeds that it returns:

The master Syndic8 feed list. This source is used by default.
Any public personal list. This source is used if the List, UserID, and (if needed) Password arguments are supplied, as indicated here.
Any Syndic8 category, as indicated here.

The feed list can then be customized by adding a Where argument to the basic URL. The Where argument can be applied to a feed list drawn from any of the sources noted above.

The Where Argument

The Where argument is a string containing one or more of the following items, separated by semicolons:

Item	Explanation
recent:N	Feeds approved within N days of the current day. N=0 is the current day.

recent:YYYY-MM-DD	Feeds approved on the given date.

changed:N	Feeds changed within N days of the current day. N=0 is the current day.

language:l1,l2,...	Feeds with the given language codes (en, es, etc.). The current implementation supports two-letter language codes only. Specifying a language code of 'en' will return feeds with a language of English for any country (en-au, en-us, etc).

dead	Feeds with a status of Dead.

appr	Feeds with a status of Awaiting Approval.

licenseid:l1,l2,...	Feeds with the given license ids (5, 7, etc.).

dataurl	Feeds with a non-null Data URL.

match:M	Feeds with fields (title, description, etc.) that match the string M.

tag:T	Feeds that are tagged with tag T.

min_latitude:L	Feeds that have geographic location information and a latitude of L or greater.

max_latitude:L	Feeds that have geographic location information and a latitude of L or smaller.

min_longitude:L	Feeds that have geographic location information and a longitude of L or greater.

max_longitude:L	Feeds that have geographic location information and a longitude of L or smaller.

The items are and'ed together.

For example, the Where clause recent:1;language:en,es would return English and Spanish feeds approved yesterday or today.

The complete URL for this request would be http://www.syndic8.com/genfeed.php?Format=ocs&Where=recent:1;language:en,es.

Personal List as Data Source

By augmenting the basic URL with the following arguments you can also download any of your personal subscription lists. Note that the UserID and List arguments must be present, and the Password argument is optional.

Argument	Explanation

UserID	Your Syndic8 UserID

Password	The MD5 hash of your Syndic8 password (cleartext can also be supplied but is not recommended). The password need not be supplied for a list that is public.

List	The integer list identifier.

Category as Data Source

Alternatively, by supplying the name of a category and the corresponding scheme for the category, the list of feeds within the given category can be downloaded.

Argument	Explanation

Scheme	A Syndic8 Category Scheme (Syndic8, DMOZ, NIF, NIF_DMOZ, etc.)

BaseCategory	The URL-encoded name of a category within the scheme.

WithChildren	If supplied and set to 1, include feeds in child categories.

For example, the URL http://www.syndic8.com/genfeed.php?Scheme=DMOZ&BaseCategory=Top%2FArts%2FMovies%2FNews_and_Media returns the feeds listed on this page of the category browser.

Paging Through Large Result Sets

It is generally not a very good idea to retrieve the entire feed list all at once without any filtering or pagination. Use the Start and Count arguments to request part of the list:

Argument	Explanation

Start	Starting point within feed list; default is 1.

Count	Number of feeds to return from feed list; default is to return all feeds.