Skip to Content

Guides

Authentication House rules App checklist SDKs and tools Our apps

API

Clear feed log POST Create a feed POST Delete a feed POST Get a feed GET List feed items GET List feeds GET Pause a feed POST Resume a feed POST Retry an item POST Retry failed items POST Update a feed POST

Register an app GitHub put.io

API/RSS feeds/List feed items

Register an app

List feed items

GEThttps://api.put.io/v2/rss/{id}/items

Returns the feed and its 50 most recently updated items.

Path

idintegerRequired

Returns

200

feedobject

itemsarray

statusstring

Errors

JSON with error_type, error_message, error_id and extra.

404Feed not found.

429Too many requests. Limits are per token and per IP. Wait until X-RateLimit-Reset, then retry.

cURL

curl https://api.put.io/v2/rss/{id}/items \
  -H "Authorization: Bearer $TOKEN"

Response · 200

{
  "feed": {
    "id": 0,
    "title": "Test RSS feed",
    "rss_source_url": "http://example.com/feed.rss",
    "parent_dir_id": 0,
    "parentdirid": 0,
    "delete_old_files": false,
    "extract": true,
    "keyword": null,
    "unwanted_keywords": "string",
    "paused": false,
    "paused_at": "2018-10-05T16:58:46",
    "last_error": "string",
    "last_fetch": "2019-08-24T14:15:22Z",
    "failed_item_count": 0,
…

Shape from the spec. Values are placeholders.

The chat didn't load

Something in your browser may be blocking it. Email us at support@put.io instead.