Podable's Developer API

Need programmatic access to podcast data? We got you covered. We currently provide a JSON API for our podcast search functionality. See the documentation below to learn more about how to use the API and what data fields are returned.

Authentication

All web requests require an API key. An API key can be created via your Podable account page. Once you have the key you can supply it via any of the following methods:

Header Query Param Form Value
X-Api-Key api-key api-key

You can easily check if your authentication is set up correctly by sending a get or post request to the following endpoint:

/api/v1/authentication

If your authentication is set up correctly the server will respond with a 200. Otherwise, the server will respond with a 403.

Podcast Search

The search API is the primary developer API for Podable. You can use the search endpoint to search for podcasts or to look up a specific podcast given a podcast url or id. The endpoint can be used by sending a get or post request to the following endpoint:

/api/v1/search

The endpoint supports the following parameters (available as query parameters or form data):

query categories recently-published
A search term to look for either in the podcast's title, description or tags. One or more categories to scope the query to. A boolean. If true, only podcasts that have published in the last 30 days will be returned.

A successful API response looks like the following:

{
  "meta": {
    "params": {
      "query": "itunes-id:id1139480348",
      "categories": null,
      "recently_published_only": false
    },
    "total_pages": 1,
    "page": 1,
    "usage": {
      "account_owner_email": "demo@podable.io",
      "queries_used": 73,
      "query_limit": 500
    }
  },
  "podcasts": [
    {
      "title": "How I Built It",
      "description": "Get insight from small business owners and developers on how they built their products, from idea to execution. You will learn real processes for launching, and evolving your business over time.",
      "authors": [
        "Joe Casabona"
      ],
      "publisher": "",
      "contact_email": "joe@wpinonemonth.com",
      "contact_phone": "",
      "contact_url": "https://howibuilt.it/sponsor/",
      "podcast_url": "https://howibuilt.it/",
      "image_url": "https://is4-ssl.mzstatic.com/image/thumb/Podcasts113/v4/ed/4c/62/ed4c6283-0137-40be-9f1d-329ca9e2f77e/mza_4878799907834939530.jpg/313x0w.jpg",
      "rss_url": "",
      "first_published_at": "2016-07-01 00:00:00 +0000 +0000",
      "last_published_at": "2020-11-19 00:00:00 +0000 +0000",
      "episode_count": 188,
      "listener_count": 0,
      "rating_count": 89,
      "rating_average": 4.10,
      "duration_average": 25,
      "tags": [
        "Software How-To",
        "Technology"
      ],
      "twitter_handle": "howibuilt",
      "instagram_handle": "howibuiltit",
      "facebook_handle": "MichaelAndreulaMethod",
      "linkedin_handle": "",
      "youtube_handle": "",
      "patreon_handle": "",
      "anchor_handle": "",
      "itunes_id": "id1139480348",
      "spotify_id": "",
      "anchor_id": "",
      "updated_at": "2020-11-22 06:10:22.834969 +0000 +0000"
    }
  ]
}