API: Tags

In this page

About the Tags API

The Tags API offers another way to discover content on Spreaker. Content exported through the Tags API returns episodes which have been hash tagged with a particular tag.

Retrieve the Latest Episodes by Tag name

GET /v2/tags/TAG-NAME/episodes

This API returns a paginated list of the latest episodes with a certain tag. If the TAG-NAME parameter contains spaces or special characters, it needs to be url encoded.

Example

curl 'https://api.spreaker.com/v2/tags/breaking+news/episodes?limit=3'
{
    "response": {
        "items": [
            {
                "episode_id": 12586749,
                "type": "EXTERNAL",
                "title": "8am EDT Newscast",
                "duration": 298630,
                "explicit": false,
                "show_id": 1537162,
                "author_id": 8395768,
                "site_url": "https://www.spreaker.com/episode/12586749",
                "published_at": "2017-08-16 12:00:00",
                "download_enabled": true,
                "waveform_url": null
            },
            {
                "episode_id": 12586106,
                "type": "EXTERNAL",
                "title": "Full Episode: Wednesday, August 16, 2017",
                "duration": 1045290,
                "explicit": false,
                "show_id": 1536967,
                "author_id": 8395426,
                "site_url": "https://www.spreaker.com/episode/12586106",
                "published_at": "2017-08-16 09:42:40",
                "download_enabled": true,
                "waveform_url": null
            },
            {
                "episode_id": 12585152,
                "type": "EXTERNAL",
                "title": "08/15/2017 - The Five Audio Podcast",
                "duration": 2760670,
                "explicit": false,
                "show_id": 2218818,
                "author_id": 8395768,
                "site_url": "https://www.spreaker.com/episode/12585152",
                "published_at": "2017-08-16 03:34:36",
                "download_enabled": true,
                "waveform_url": null
            }
        ],
        "next_url": "https://api.spreaker.com/v2/tags/breaking+news/episodes?last_id=12585152&limit=3"
    }
}