API: Show RSS Metadata

The Show RSS Metadata object

Show creators can customize the RSS feed information of the show. The RSS Metadata object has the following properties:

Property Type Description
show_id Numeric Unique show identifier
mode String RSS customization mode
title String Show title
subtitle String Show subtitle
summary String Show summary
language String Show main language
website_url String Contact website
copyright String Copyright information
owner_name String Owner’s name
owner_email String Owner’s email
author_name String Author’s name
explicit Boolean Whether the show contains explicit content or not
image_url String Image URL
category Numeric Unique category identifier
itunes_category Numeric Unique category identifier
itunes_category_2 Numeric Unique category identifier
itunes_category_3 Numeric Unique category identifier
prepend_url String Tracking URL prefix
redirect_url String Redirect URL
googleplay_image_url String Google Play image URL
googleplay_description String Google Play image Description
googleplay_category Numeric Google Play category unique identifier
googleplay_email String Google Play email contact
googleplay_author String Google Play author name
googleplay_explicit Boolean Whether the show contains explicit content or not for Google Play
auto_fields Show RSS Metadata Default values when mode is AUTO

Retrieving Show RSS Metadata

GET /v2/shows/SHOW-ID/rss-metadata

Authenticated: yes. Owner: yes

This API returns the RSS Metadata information for the given Show. The RSS feed of the show will be available at this URL: https://www.spreaker.com/show/SHOW-ID/episodes/feed

Example

curl -H "Authorization: Bearer OAUTH-TOKEN" https://api.spreaker.com/v2/shows/12345678/rss-metadata
{
    "response": {
        "metadata": {
            "show_id": 12345678,
            "mode": "MANUAL",
            "title": "A custom title",
            "subtitle": "A custom subtitle",
            "summary": "A custom summary",
            "language": "en",
            "website_url": "https://www.spreaker.com/show/a-show-with-custom-rss",
            "copyright": "Copyright Author Name",
            "owner_name": "Owner name",
            "owner_email": "feeds@spreaker.com",
            "author_name": "Author Name",
            "explicit": false,
            "image_url": "https://example.com/image.png",
            "category": 357,
            "itunes_category": 357,
            "itunes_category_2": null,
            "itunes_category_3": null,
            "prepend_url": null,
            "redirect_url": null,
            "googleplay_image_url": null,
            "googleplay_description": null,
            "googleplay_category": 1,
            "googleplay_email": "feeds@spreaker.com",
            "googleplay_author": "Author Name",
            "googleplay_explicit": false,
            "auto_fields": {
                "title": "A custom title",
                "subtitle": null,
                "summary": null,
                "language": "en",
                "website_url": "https://www.spreaker.com/show/a-show-with-custom-rss",
                "copyright": "Copyright Author Name",
                "owner_name": "Owner Name",
                "owner_email": "feeds@spreaker.com",
                "author_name": "Author Name",
                "explicit": false,
                "category": 357,
                "itunes_category": 357,
                "itunes_category_2": null,
                "itunes_category_3": null,
                "image_url": "https://example.com/image.png",
                "image_width": null,
                "image_height": null,
                "prepend_url": null,
                "redirect_url": null,
                "googleplay_image_url": null,
                "googleplay_description": null,
                "googleplay_category": 1,
                "googleplay_email": "feeds@spreaker.com",
                "googleplay_author": "Author Name",
                "googleplay_explicit": false,
                "mode": "AUTO"
            }
        }
    }
}

Customize Show RSS Metadata

POST /v2/shows/SHOW-ID/rss-metadata

Authenticated: yes. Owner: yes

The API POST /v2/shows/SHOW-ID/rss-metadata supports these parameters:

Parameter Type Description
mode String RSS customization mode, one of: AUTO, MANUAL, REDIRECT, DISABLED
title String Show title - i.e. <title>
subtitle String Show subtitle - i.e. <itunes:subtitle>
summary String Show summary - i.e. <description>, <itunes:summary>
language String Show main language as ISO 639-1 language code. E.g. en, fr See: Languages - i.e. <language>
website_url String Show website - i.e. <link>
copyright String Show copyright information - i.e. <copyright>
owner_name String Show owner name - i.e. <itunes:owner><itunes:name></itunes:owner>
owner_email String Show owner email - i.e. <itunes:owner><itunes:email></itunes:owner>
author_name String Show author name - i.e. <itunes:author>
explicit Boolean true if your podcast contains explicit content - i.e. <itunes:explicit>
prepend_url String Tracking URL prefix
redirect_url String Redirect URL to be used when mode is REDIRECT
category Number Unique category identifier. See: Categories - i.e. <category>
itunes_category Number Unique category identifier. See: Categories - i.e. <itunes:category>
itunes_category_2 Number Unique category identifier. See: Categories - i.e. <itunes:category>
itunes_category_3 Number Unique category identifier. See: Categories - i.e. <itunes:category>
image_file File At least 1400x1400 pixels and max 3000x3000, max size: 16MB, Formats: JPG, PNG - i.e. <itunes:image>
googleplay_image_file File At least 1200x1200 pixels and max 7000x7000, max size: 16MB, Formats: JPG, PNG - i.e. <googleplay:image>
googleplay_description String Show description - i.e. <googleplay:description>
googleplay_category Number Unique category identifier. See: Google Play Categories - i.e. <googleplay:category>
googleplay_email String Show owner email - i.e. <googleplay:email>
googleplay_author String Show author - i.e. <googleplay:author>. If the <googleplay:author> tag isn’t included, <itunes:author> will be used instead.
googleplay_explicit Boolean true if your podcast contains explicit content - i.e. <googleplay:explicit>