Audio

Richie Audio API Endpoints

Descriptions of endpoints for audio metadata

GET /books/feeds/v3/{tenant_name}/podcast_episode/{episode_uuid}.json

Get metadata of a podcast episode. Does not need authentication.

Example response

{
    "data": {
        "ad_tags": null,
        "analytics_data": null,
        "audio_duration": 151,
        "audio_length": 1209616,
        "audio_pkgs": {},
        "audio_sample": null,
        "audio_url": "https://appdata.richie.fi/audiobooks/Nelonen/3bda2fbd-1e86-4c49-a654-4219473c23fa/ced34f_Rock_Uutiset_101224.mp3",
        "author": "",
        "availability_periods": [
            {
                "end_date": "2099-12-31T23:59:59Z",
                "product": null,
                "start_date": "2024-12-10T14:00:00Z",
                "type": "free"
            }
        ],
        "cover_url": "https://data.richie.app/books-images/m/Nelonen/uploads/029eb1e78c_Kuuntelep_iv_nt_rkeimm_trock_uutiset_kuva.jpg",
        "description": "Rock Uutisissa tänään mm. Suomeen saapuva Scorpionsin juhlakiertue.",
        "guid": "2b06a1b3-8557-4032-a044-f80c382872f8",
        "h": null,
        "kind": "podcast_episode",
        "last_modified": "2024-12-10T14:00:43.948607Z",
        "original_article_url": "",
        "photo_author": "",
        "publication_date": "2024-12-10T14:00:00Z",
        "rankings": {
            "daily": null,
            "monthly": null,
            "weekly": null
        },
        "series_guid": "666a9c8d-9e5e-4bb7-b9f1-9fcc1418e4b7",
        "series_tags": [],
        "series_title": "Rock-uutiset",
        "source_type": "manual",
        "square_cover_url": null,
        "square_photo_author": null,
        "tags": [],
        "title": "Rock Uutiset 10.12."
    }
}

Schema of "data"

"data" follows the schema for a podcast episode, with some article compatibility fields left empty.

PropertyDescriptionValue
kindKind (type) of the resource."podcast_episode"
source_typeOrigin of the episode."rss", "manual" or "article"
guidIdentifier of the episode.UUID
series_titleTitle of the series episode belongs to.String
series_guidIdentifier of the series episode belongs to.UUID
authorEpisode author.String
original_article_urlOriginal article URL. Empty for actual podcast episodes.String
titleEpisode title.String
descriptionEpisode description.String
publication_dateEpisode's first publication date.String (a date)
last_modifiedLast time the metadata was updated.String (a date).
cover_urlURL for a cover picture.String (an HTTPS URL).
photo_authorAuthor of the related photo. Empty for actual podcast episodes.String
square_cover_urlURL for a cover picture, guaranteed to be square. Empty for actual podcast episodes.String (an HTTPS URL) or null.
square_photo_authorURL for a cover picture, guaranteed to be square. Empty for actual podcast episodes.String or null.
audio_urlPlayback URL for the main audio.String (an HTTPS URL).
audio_durationDuration of audio in seconds. 0 and null mean duration is unknown.Integer (incl. 0) or null.
audio_lengthContent length of audio file, in bytes. 0 means unknown length.Integer (incl. 0).
audio_sampleDetails of a free sample version for audio. Not available for all episodes.Object or null.
audio_sample.audio_urlPlayback URL for the sample version.String (an HTTPS URL) if audio_sample is an object.
audio_sample.audio_durationDuration of audio in seconds. 0 and null mean duration is unknown.Integer (incl. 0) or null if audio_sample is an object..
audio_sample.audio_lengthContent length of audio file, in bytes. 0 means unknown length.Integer (incl. 0) if audio_sample is an object..
audio_pkgsRichie-managed alternative format audio packages. Details agreed with integrators.Object, possibly empty.
availability_periodsTime frames during which the episode is available in given products.Array of objects (availability period objects).
availability_periods[n].productProduct slug.String or null.
availability_periods[n].productType of the product (free or paid)."free" or "paid".
availability_periods[n].productStart of episode's inclusion in the product.String (a date).
availability_periods[n].end_dateEnd of episode's inclusion in the product.String (a date).
rankingsPopularity rankings for the episode.Object
rankings.dailyDaily popularity for the episode, if applicable. Lower number means more popular.Integer or null.
rankings.weeklyWeekly popularity for the episode, if applicable. Lower number means more popular.Integer or null.
rankings.monthlyMonthly popularity for the episode, if applicable. Lower number means more popular.Integer or null.
series_tagsTenant-specific values agreed with the tenant, for the series episode belongs to.Array of strings.
tagsTenant-specific values agreed with the tenant, for the episode.Array of strings.
analytics_dataTenant-specific data carried for analytics purposes. Actual fields agreed with the tenant.Object or null.
ad_tagsTenant-specific data carried for ad purposes. Actual fields agreed with the tenant.Object or null.
hInternal hash code over the payload, not always set.String or null.
Previous
Push Credentials