List Listens

Endpoint

GET /listens - get list of user’s podcast episodes listening sessions

Parameters

Parameter Parameter Type Data Type
api-key header string Required
Authorization header string Required
include query string available includes: episode
type query string available values: episode,record

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

Response fields

An array of listen objects containing a link between an user and a podcast episode.

  • id - id of listening session
  • user_id - user_id
  • episode_id - id of the episode being listened
  • progress - progress
  • tyoe - type of listen: episode|record
  • episode - an episode object (see episode-single endpoint)

Example response for type=record

{
    "data": [
        {
            "id": 8,
            "episode_id": 3,
            "user_id": 4,
            "progress": 151.1,
            "record": {
                "id": 3,
                "title": "Popescu si Cuza alt episod",
                "description": "alt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt textalt text",
                "tag": "Popescu si Cuza",
                "audioUrl": "https:\/\/cms.digitalag.ro\/cms_websites\/cms_radiozu\/library\/audio\/2022\/08\/PC20220303.mp3",
                "duration": 4740,
                "image": "https:\/\/cms.digitalag.ro\/cms_websites\/cms_radiozu\/library\/img\/2009\/03\/siglazu-one-radio.jpg",
                "published_at": "2022-08-01 15:18:00",
                "show": {
                    "id": 14,
                    "title": "Popescu și Cuza",
                    "description": "Să înceapă veselia cu Popescu și Cuza",
                    "details": "De luni până vineri, de la 16 la 18",
                    "image": "https:\/\/cms.digitalag.ro\/cms_websites\/cms_radiozu\/popescucuzashow.jpg"
                }
            }
        }
    ]
}

Example response for type=episode (default)

{
    "data": [
        {
            "id": 1,
            "episode_id": 33,
            "user_id": 4,
            "progress": 15.1,
            "type": "episode",
            "episode": {
                "id": 33,
                "title": "RENAȘTEREA ANDREEI MARIN: “SINGURA MEA FERICIRE ERA COPILUL”. | Fain & Simplu cu Mihai Morar 050",
                "episode_number": 50,
                "description": "Andreea Marin vorbește cu Mihai Morar despre pierderea mamei la o vârstă fragedă, plecarea de la Surprize, Surprize, nepotrivirile de caracter și planurile de viitor.Una dintre primele vedete din România, inegalabila Andreea Marin ne destăinuie astăzi povestea din spatele camerelor de filmat. Povestea unei femei puternice și de succes, care a întruchipat, timp de 10 ani, celebra prezentatoare - vedetă a emisiunii Surprize, surprize, una dintre cele mai urmărite emisiuni românești din toate timpurile.Invitata de astăzi a lui Mihai Morar se dezvăluie așa cum nu o știm; își amintește trauma pierderii mamei, la doar 9 ani, lupta constantă pentru familia ei, sau greutățile de antreprenor pe care le-a înfruntat după ieșirea de pe ecran.Aceasta este povestea Andreei Marin. Serioasă, amuzantă, ’’obositor de organizată‘’ și un etern spirit tânăr.",
                "duration": 6161,
                "audio_url": "https:\/\/www.buzzsprout.com\/659008\/10048118-rena-terea-andreei-marin-singura-mea-fericire-era-copilul-fain-simplu-cu-mihai-morar-050.mp3",
                "video_url": null,
                "guests": "Andreea Marin",
                "share_url": "https:\/\/podcasts.radiozu.ro\/episodes\/33",
                "image": "https:\/\/cms-podcasts.radiozu.ro\/storage\/K3RCUT3S3EPVKwyHKhMjnxdb7B5eCa.jpg",
                "published_at": "2022-02-10 11:00:00"
            }
        }
    ]
}