|
|
» Log In » Register » Suggest » Feeds » News » Podcasts » Tags » Pings » Documents » XML » Web Services » Categories » Statistics » Help » Site Map » About |
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 |
The genfeed.php script can use any one of the following sources for the list of feeds that it returns:
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 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.
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. |
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.
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. |
The customization mechanism is open-ended and we are open to suggestions for new types of items. Mail your suggestions to Jeff Barr.