Return to Developer Console

Podcast Directory

Allows you to search for and discover podcasts for use by the Podcasts API.

Client Keys are required for all requests. These are used to track API use and ensure that directory use is consistent with my Terms of Use.

Search for Podcasts

Limits results to 25 matches. Sorted by Popularity. Searches podcast title, description and provider.
https://feedwrangler.net/api/v2/podcasts/search
Name Required Notes
search_term YES
client_key YES The client key for your application. Client keys are managed here.
Success:
{
    "count":1,
    "podcasts":[
        {"title":"Accidental Tech Podcast",
        "podcast_id":26,
        "image_url":"http://static.squarespace.com/.../ATP-logo.jpg",
        "feed_url":"http://atp.fm/episodes?format=rss"
    }],
    "error":null,
    "result":"success"
}

List of 50 most popular podcasts

https://feedwrangler.net/api/v2/podcasts/popular
Name Required Notes
client_key YES The client key for your application. Client keys are managed here.
Success:
{
    "count":50,
    "podcasts":[
        {
            "title":"Accidental Tech Podcast",
            "podcast_id":26,
            "image_url":"http://static.squarespace.com/.../ATP-logo.jpg",
            "feed_url":"http://atp.fm/episodes?format=rss"
        },{
            "title":"This American Life",
            "podcast_id":2,
            "image_url":"http://www.thisamericanlife.org/.../logo-square-1400.jpg",
            "feed_url":"http://feeds.thisamericanlife.org/talpodcast"},
        },
        ...
    ],
    "error":null,
    "result":"success"
}

List Podcast Categories

The image_url returned is for the most popular show in the category.
https://feedwrangler.net/api/v2/podcasts/categories
Name Required Notes
client_key YES The client key for your application. Client keys are managed here.
Success:
    {
        "count": 17, 
        "error": null, 
        "podcasts": [
            {
                "image_url": "http://assets.libsyn.com/content/5828316.jpg", 
                "podcasts_url": "/api/v2/podcasts/category/145", 
                "title": "Arts",
                "category_id" => 145
            }, 
...
            {
                "image_url": "http://media.npr.org/images/podcasts/2013/primary/ted_radio_hour.png", 
                "podcasts_url": "/api/v2/podcasts/category/149", 
                "title": "Technology"
                "category_id" => 149
            }, 
        ], 
        "result": "success"
    }

Retrieve shows in Category

Limits results to 50 matches. Sorted by Popularity.
https://feedwrangler.net/api/v2/podcasts/category
Name Required Notes
id YES
client_key YES The client key for your application. Client keys are managed here.
Success:
{
    "count":1,
    "podcasts":[
        {"title":"Accidental Tech Podcast",
        "podcast_id":26,
        "image_url":"http://static.squarespace.com/.../ATP-logo.jpg",
        "feed_url":"http://atp.fm/episodes?format=rss"
    }],
    "error":null,
    "result":"success"
}

List Podcast Providers

The image_url returned is for the most popular show in the provider's catalog. Limited to 50 most prolific providers.
https://feedwrangler.net/api/v2/podcasts/providers
Name Required Notes
client_key YES The client key for your application. Client keys are managed here.
Success:
    {
        "count": 50, 
        "error": null, 
        "podcasts": [
            {
                "image_url": "http://www.thisamericanlife.org/sites/all/themes/thislife/images/logo-square-1400.jpg", 
                "podcasts_url": "/api/v2/podcasts/provider/2", 
                "title": "Chicago Public Media",
                "provider_id":2
            }, 
            ...
            {
                "image_url": "http://icebox.5by5.tv/images/broadcasts/29/cover.jpg", 
                "podcasts_url": "/api/v2/podcasts/provider/3", 
                "title": "5by5"
                "provider_id":3
            }, 
        ], 
        "result": "success"
    }


Retrieve shows by a Provider

Limits results to 50 matches. Sorted by Popularity.
https://feedwrangler.net/api/v2/podcasts/provider
Name Required Notes
id YES
client_key YES The client key for your application. Client keys are managed here.
Success:
{
    "count":1,
    "podcasts":[
        {"title":"Accidental Tech Podcast",
        "podcast_id":26,
        "image_url":"http://static.squarespace.com/.../ATP-logo.jpg",
        "feed_url":"http://atp.fm/episodes?format=rss"
    }],
    "error":null,
    "result":"success"
}

Retrieve details for a show

https://feedwrangler.net/api/v2/podcasts/show
Name Required Notes
podcast_id YES
client_key YES The client key for your application. Client keys are managed here.
Success:
    {
        "error": null, 
        "podcast": {
            "feed_url": "http://atp.fm/episodes?format=rss", 
            "image_url": "http://static.squarespace.com/static/.../1500w/ATP-logo.jpg", 
            "podcast_id": 26, 
            "recent_episodes": [
                {
                    "audio_url": "http://traffic.libsyn.com/atpfm/atp24.mp3", 
                    "title": "24: Double Meta"
                }, 
                ...
                {
                    "audio_url": "http://traffic.libsyn.com/atpfm/atp1.mp3", 
                    "title": "1: iPhone Plus"
                }
            ], 
            "summary": "Three nerds discussing tech and loosely related matters. An offshoot from Neutral, our car show.", 
            "title": "Accidental Tech Podcast"
        }, 
        "result": "success"
    }


Developer Inquiries