Feedoor - Entrance to Feed management world

Feed API

Retrieve your feed's content with our Feed API.

Contents:

API URL
Request Parameters
Get Query Example
JSON Response
XML Response
Error Responses

API URL

http://feedoor.com/api/feed

Method: Get

Request Parameters

Required	Name	value	Description
yes	sub	(your feed address)	This is the sub address of your feed, for example if your feed address is http://blogrss.feedoor.com then your sub is "blogrss".
optional	limit	(0-50)	Number of items to display. Default value is "10"
optional	chars	(25-500)	Number of characters to display for each item, default value is "100"
optional	output	(xml or json)	Desired response format. Default value is "xml"
optional	callback		Available with JSON output only, this parameter will wrap your json output in a callback javascript function.
optional	dformat	(0,1,2,3,4)	Display Time in different formats 0 = 17/4/2006 1= 4/17/2006 2 = April, 17 2006 3 = Wed, 17 Apr 2006 4 = Wed, 17 Apr 2006 16:04:32 GMT

GET Query Example

http://feedoor.com/api/feed?sub=XXX&limit=10&chars=200&output=xml&dformat=4

JSON Rsponse
The following results will be presented when you request JSON format.

feed

title: Feed title..
link: Feed URL link
description: Feed description
author: Feed author

items[]: List of all Feed's items

item[]
title: Item title.
link: Item URL link.
description: Item description
publishedDate: Item publishing date

JSON Response Example

{"feed": { "title":"Feed Title", "link":"Feed Link", "author":"Author", "description":"Feed Description", "items":[ { "pubDate": "Thu, 01 Jan 1980 02:00:00 GMT", "title": "first item title", "link": "http://www.first-item-link.com", "description": "first item description TEXT only" }, { "pubDate": "Fri, 02 Jan 1980 02:17:00 GMT", "title": "second item title", "link": "http://www.second-item-link.com", "description": "second item description TEXT only" }, ] } }

XML Rsponse
The following results will be presented when you request XML format.

<feed>

< title>: Feed title..
<link>: Feed URL link
<description>: Feed description
<author>: Feed author

<items>: List of all Feed's items

<item>: start of the item node
< title>: Item title.
<link>: Item URL link.
<description>: Item description
<pubDate>: Item publishing date

XML Response Example

<feed> <title>Feed Title</title> <link>Feed URL link</link> <description>Feed description</description> <author>Author Name</author> <items> <item> <pubDate>Thu, 01 Jan 1980 09:00:00 GMT</pubDate> <title>First Item Title</title> <link>http://first-item-link.com</link> <description>First item description</description> </item> <item> <pubDate>Fri, 02 Jan 1980 02:20:00 GMT</pubDate> <title>Second Item Title</title> <link>http://second-item-link.com</link> <description>Second item description</description> </item> </items> </feed>

Errors Response

XML Error Example

<error> <code>1</code> <message>Requested Feed is not available</message> </error>

JSON Error Example

{ error:{ code:1, message:'Requested Feed is not available' } }

Error Codes and their associated messages

Code	Error message
1	Requested Feed is not available.
2	Required Parameter is Missing.
3	An unknow error occurred.