Return to Developer Console

Podcasts

Access Tokens are generated via the Authorization APIs. Use of these APIs will require that the user has a paid membership.

Subscribe to Podcast

Subscribes the user to the podcast with given podcast_id.
https://feedwrangler.net/api/v2/podcasts/subscribe
Name Required Notes
access_token YES
podcast_id YES
Success:
{
    "error":null,
    "result":"success"
}

Subscribe to Podcast Feed and Import

Given a podcast feed URL, subscribe the user to the podcast.
https://feedwrangler.net/api/v2/podcasts/subscribe_and_wait
Name Required Notes
access_token YES
feed_url YES Should be fully qualified URL for the podcast's RSS feed
Success:
{
    "podcast":{
        "podcast_id":26,
        "title":"Accidental Tech Podcast",
        "summary":"Three nerds discussing tech and loosely related matters. An offshoot from Neutral, our car show.",
        "feed_url":"http://atp.fm/episodes?format=rss",
        "image_url":"http://static.squarespace.com/static/513abd71e4b0fe58c655c105/t/513ac9b6e4b00efcff53af07/1362807225394/1500w/ATP-logo.jpg"
    },
    "error":null,
    "result":"success"
}

Unsubscribe from Podcast

https://feedwrangler.net/api/v2/podcats/unsubscribe
Name Required Notes
access_token YES
podcast_id YES
Success:
{
    "error":null,
    "result":"success"
}

Update User's progress for a given podcast episode

This should not be called any more quickly than every 10 seconds. Do not update the user's progress bookmark every second.
https://feedwrangler.net/api/v2/podcasts/update
Name Required Notes
access_token YES
episode_id YES
heard NO true or false
progress NO Integer representing the number of seconds from the beginning of the episode the user has listened.
Success:
{
    "episode":{
        "episode_id":10395,
        "deleted":false,
        "podcast_id":9,
        "published_at":1298072008,
        "created_at":1377200041,
        "updated_at":1377269980,
        "heard":false,
        "progress":10
    },
    "error":null,
    "result":"success"
}

Update User's heard/unheard status for a given collection of podcast episodes.

https://feedwrangler.net/api/v2/podcasts/update_multiple
Name Required Notes
access_token YES
episode_ids YES Comma separated list of episode_id values. For Example, "10395,10396"
heard YES true or false
Success:
{
    "count": 2
    "episodes":[
        {
        "episode_id":10395,
        "deleted":false,
        "podcast_id":9,
        "published_at":1298072008,
        "created_at":1377200041,
        "updated_at":1377269980,
        "heard":false,
        "progress":10
        },
        {
        "episode_id":10396,
        "deleted":false,
        "podcast_id":9,
        "published_at":1298072008,
        "created_at":1377200041,
        "updated_at":1377269980,
        "heard":false,
        "progress":102
        },
    ]
    "error":null,
    "result":"success"
}

Subscribed Podcasts

https://feedwrangler.net/api/v2/podcasts/podcasts
Name Required Notes
access_token YES
known_podcast_ids NO Comma separated list of podcast_ids that you know about. Any ids no longer subscribed will be returned in deleted_podcast_ids
Success:
{
    "podcasts":[
        {
            "podcast_id":26,
            "title":"Accidental Tech Podcast",
            "summary":"Three nerds discussing tech and loosely related matters. An offshoot from Neutral, our car show.",
            "feed_url":"http://atp.fm/episodes?format=rss",
            "image_url":"http://static.squarespace.com/.../1500w/ATP-logo.jpg"
    }],
    "deleted_podcast_ids":[1],
    "error":null,
    "result":"success"
}

Get Episodes the user is subscribed to

https://feedwrangler.net/api/v2/podcasts/episodes
Name Required Notes
access_token YES
limit NO Max value is 100
offset NO
updated_since NO Unix timestamp to return episodes updated since. Includes both new episodes and changes made by /update
heard NO Return only episodes that are (un)heard. true or false
podcast_id NO Return only subscribed episodes in a given podcast_id.
Success:
{
    "count":1,
    "episodes":[
    {
        "episode_id":11588,
        "podcast_id":26,
        "published_at":1375381861,
        "created_at":1377269352,
        "updated_at":1377269711,
        "url":"http://atp.fm/episodes/24-double-meta",
        "title":"24: Double Meta",
        "heard":false,
        "progress":0,
        "deleted":false,
        "guid":"513abd71e4b0fe58c655c105:513abd71e4b0fe58c655c111:51faa972e4b002b80b1d9bb8",
        "duration":6013,
        "show_notes":"....",
        "audio_url":"http://traffic.libsyn.com/atpfm/atp24.mp3"
    },
    "error":null,
    "result":"success"
}

Get Episode IDs the user is subscribed to

https://feedwrangler.net/api/v2/podcasts/episode_ids
Name Required Notes
access_token YES
limit NO Max value is 1000
offset NO
updated_since NO Unix timestamp to return episodes updated since. Includes both new episodes and changes made by /update
heard NO Return only episodes that are (un)heard. true or false
podcast_id NO Return only subscribed episodes in a given podcast_id.
Success:
{
    "count":1,
    "episodes":[
    {
        "episode_id":11588,
        "updated_at":1377269711,
        "deleted":false,
    },
    "error":null,
    "result":"success"
}

Get Episode(s) for ID

https://feedwrangler.net/api/v2/podcasts/get
Name Required Notes
access_token YES
episode_ids YES Comma Separated List of episode_id values to retrieve.
Success:
    {
        "count":1,
        "episodes":[
        {
            "episode_id":11588,
            "podcast_id":26,
            "published_at":1375381861,
            "created_at":1377269352,
            "updated_at":1377269711,
            "url":"http://atp.fm/episodes/24-double-meta",
            "title":"24: Double Meta",
            "heard":false,
            "progress":0,
            "deleted":false,
            "guid":"513abd71e4b0fe58c655c105:513abd71e4b0fe58c655c111:51faa972e4b002b80b1d9bb8",
            "duration":6013,
            "show_notes":"....",
            "audio_url":"http://traffic.libsyn.com/atpfm/atp24.mp3"
        },
        "error":null,
        "result":"success"
    }



Developer Inquiries