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 recently-published
A search term to look for either in the podcast's title, description, category, tags or social id. A boolean. If true, only podcasts that have published in the last 30 days will be returned.

A number of social id query parameters can be used to look up data for a specific podcast. For instance, the following can be used in your query string:

A successful API response looks like the following:

{
  "meta": {
    "params": {
      "query": "itunes-id:id1139480348",
      "recently_published_only": false
    },
    "total_pages": 1,
    "page": 1,
    "usage": {
      "account_owner_email": "demo@podable.io",
      "podcasts_used": 73,
      "podcast_limit": 300
    }
  },
  "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"
    }
  ]
}

Note, each podcast returned in the response will count towards your monthly podcast quota. However, each podcast only counts once per-period. If your query returns a podcast you have already viewed the request won't be counted towards your quota.