Podcast Single

Endpoint

GET /podcasts/{id} - Get podcast details for a single podcast

Parameters

Parameter Parameter Type Data Type
api-key header string Required
Authorization header string Required
include query string available includes: episodes, episodes.listen, subscription, links

Error messages

  • invalid HTTP_API_KEY
  • Not authenticated

HTTP response codes:

  • 200 - Success
  • 401 - Unauthorized action

Example request

curl --request GET \
  --url 'https://api-dev.radiozu.ro/v1/podcasts/1?include=subscription' \
  --header 'Authorization: Bearer AUTH_TOKEN' \
  --header 'api-key: API_KEY'

Response fields

A single podcast object. One podcast object is described by:

  • id - podcast id
  • name - podcast name, string
  • description - nullable, string
  • feed_url - string
  • image - nullable, string
  • subscription - nullable, subscription object
  • episodes - nullable, array of episode objects

Example response

{
  "data": {
    "id": 2,
    "name": "podcast de test",
    "active": 1,
    "description": "podcast de testpodcast de testpodcast de test",
    "host": "RadioZU",
    "feed_url": "https:\/\/anchor.fm\/s\/7ea57f84\/podcast\/rss",
    "image": "https:\/\/cms-podcasts.radiozu.ro\/storage\/ehpfrAbQ9rP7aNStfOe217V9T437xY.jpg"
  }
}