Episode List

Endpoint

GET /episodes - Get a list of podcast episodes

Parameters

Parameter Parameter Type Data Type
api-key header string Required
Authorization header string Required
filter query string, available filters:podcast_id
include query string available includes: listen

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/episodes' \
  --header 'Authorization: Bearer AUTH_TOKEN' \
  --header 'api-key: API_KEY'

Response fields

An array containing multiple episodes objects. One episode object is described by:

  • id - episode id
  • title - episode name, string
  • description - nullable, string
  • episode_number - nullable, integer
  • duration - episode duration in seconds, integer
  • audio_url - string
  • video_url - string, nullable
  • image - nullable, string
  • published_at - nullable, string

Example response

{
    "data": [
        {
            "id": 89,
            "title": "Episod de test",
            "episode_number": 1,
            "description": "o descriere de test pentru un episod de test\n",
            "duration": 6907,
            "audio_url": "https:\/\/anchor.fm\/s\/7ea57f84\/podcast\/play\/55124179\/https%3A%2F%2Fd3ctxlq1ktw2nl.cloudfront.net%2Fstaging%2F2022-6-21%2F77a5b31c-bcbd-25fe-a34a-a993b97c01e3.mp3",
            "video_url": null,
            "guests": "",
            "share_url": "https:\/\/podcasts.radiozu.ro\/episodes\/89",
            "image": "https:\/\/cms-podcasts.radiozu.ro\/storage\/4UiiVRS1I7BpCMBkZcX4yHNBGrXtbr.png",
            "published_at": "2022-07-21 09:30:08"
        }
    ]
}