FetchRSS API


Your API auth key will be here after registration.

General information

This API provides a programmatic access to basic FetchRSS functionality.

All API requests must be sent via HTTP protocol to a special endpoints URL. Using this pattern:
http://fetchrss.com/api/v1/ENDPOINT?auth=YOUR-API-AUTH-KEY&OTHER-PARAMETERS

Each API request must be authenticated by adding ?auth=YOUR-API-AUTH-KEY to a request parameters.
YOUR-API-AUTH-KEY - is your personal key. It can be found at the top of this page.

End-Points

/feed/create

Create an RSS feed. Returns a link to created RSS

Parameters:

Key Required Description Example
url required Target URL http://facebook.com/cnn

Example Request:

http://fetchrss.com/api/v1/feed/create?auth=YOUR-API-AUTH-KEY&url=http%3A%2F%2Ffacebook.com%2Fcnn

Example Response:

{
    "success": true,
    "feed": {
        "id": "5875fec344607288628a9249",
        "rss_url": "http://fetchrss.com/rss/566b1cbb8a93f85e53b226f467587692067.xml"
    },
    "target_url": "http://facebook.com/cnn"
}
If you need to create a feed out of a general web page. You'll need to add a target page parsing selectors. It must be a CSS selectors.

Parameters:

Key Required Description Example
url required Target URL https://www.nobelprize.org/
news-selector required News DOM selector
Note: All other selectors must be inside of this DOM
div.row > div.columns
title-selector required News title selector div.row > div.columns > h2
content-selector required News summery selector div.row > div.columns > p
pic-selector optional News illustration selector
date-selector optional News publish date selector
author-selector optional News author selector
link-selector optional News link selector

Example Request:

http://fetchrss.com/api/v1/feed/create?auth=YOUR-API-AUTH-KEY&url=https%3A%2F%2Fwww.nobelprize.org%2F&news-selector=div.row+%3E+div.columns&title-selector=div.row+%3E+div.columns+%3E+h2&content-selector=div.row+%3E+div.columns+%3E+p

/feed/list

Get a list of all user feeds

Example Request:

http://fetchrss.com/api/v1/feed/list?auth=YOUR-API-AUTH-KEY

Example Response:

{
    "success": true,
    "feeds": [
        {
            "id": "5875fec344607288628a9249",
            "title": "CNN on Facebook",
            "rss_url": "http://fetchrss.com/rss/566b1cbb8a93f85e53b226f467587692067.xml"
        },
        {
            "id": "587601d3446072e9628a9249",
            "title": "Nobelprize.org",
            "rss_url": "http://fetchrss.com/rss/566b1cbb8a93f85e53b226f496051329546.xml"
        }
    ]
}

/feed/delete

Delete user RSS

Parameters:

Key Required Description Example
id required RSS ID 5875fec344607288628a9249

Example Request:

http://fetchrss.com/api/v1/feed/delete?auth=YOUR-API-AUTH-KEY&id=5875fec344607288628a9249

Example Response:

{
    "success": true
}