API: Explore

In this page

About the Explore API

The Explore API offers another way to discover content on Spreaker. Content exported through the Explore API is clustered together based on different criteria. We currently support:

  • Curated Lists: lists of shows where each list contains shows related to a specific topic. The shows listed are both manually picked by our editorial staff and automatically picked by our ranking algorithms.

Retrieving Curated Lists

GET /v2/explore/lists

This API returns a paginated list of curated lists.

Parameter Type Description
country String Filters curated lists by country. The string accepts an ISO 3166-1 country code (ie. US, GB, IT), that if omitted will only list the few multi-country curated lists available.

Example

curl 'https://api.spreaker.com/v2/explore/lists?country=US&limit=3'
{
    "response": {
        "items": [{
            "list_id": 108,
            "name": "Featured This Week",
            "subtitle": null,
            "type": "shows"
        }, {
            "list_id": 107,
            "name": "Popular Shows",
            "subtitle": null,
            "type": "shows"
        }, {
            "list_id": 109,
            "name": "Staff Pick",
            "subtitle": null,
            "type": "shows"
        }],
        "next_url": "https://api.spreaker.com/v2/explore/lists?country=US&last_id=109&limit=3"
    }
}

Retrieving a Single Curated List

GET /v2/explore/lists/LIST-ID

This API returns information on a single curated list, without including its items. To list its items please see Retrieving a Curated List’s Items.

Example

curl 'https://api.spreaker.com/v2/explore/lists/108'
{
    "response": {
        "list": {
            "list_id": 108,
            "name": "Featured This Week",
            "subtitle": null,
            "type": "shows"
        }
    }
}

Retrieving a Curated List’s Items

GET /v2/explore/lists/LIST-ID/items

This API returns a paginated list of items. The list items’ sorting is based on an internal ranking algorithm that pushes the most popular and highest quality content to the top of the list. The returned items depend on the curated list’s type property.

Curated lists currently support the following types:

  • shows: the curated list contains Shows

Example

curl 'https://api.spreaker.com/v2/explore/lists/108/items?limit=3'
{
    "response": {
        "items": [{
            "show_id": 1660908,
            "title": "Barely Friending",
            "site_url": "https://www.spreaker.com/show/barely-friending_1",
            "image_url": "https://d1bm3dmew779uf.cloudfront.net/large/ccbe3e17c7ee5e30a8ecd43ac5a62b8b.jpg",
            "image_original_url": "https://d3wo5wojvuv7l.cloudfront.net/images.spreaker.com/original/ccbe3e17c7ee5e30a8ecd43ac5a62b8b.jpg",
            "author_id": 8647876
        }, {
            "show_id": 1671386,
            "title": "The Way I Heard It with Mike Rowe",
            "site_url": "https://www.spreaker.com/show/the-way-i-heard-it-with-mike-rowe_1",
            "image_url": "https://d1bm3dmew779uf.cloudfront.net/large/f4fbc9e8910b903668490f7cd6d8163c.jpg",
            "image_original_url": "https://d3wo5wojvuv7l.cloudfront.net/images.spreaker.com/original/f4fbc9e8910b903668490f7cd6d8163c.jpg",
            "author_id": 8671031
        }, {
            "show_id": 1441069,
            "title": "BodegaBoxOffice",
            "site_url": "https://www.spreaker.com/show/bodegaboxoffice",
            "image_url": "https://d1bm3dmew779uf.cloudfront.net/large/f2a21ffdc6cdf1891c961f23eec04927.jpg",
            "image_original_url": "https://d3wo5wojvuv7l.cloudfront.net/images.spreaker.com/original/f2a21ffdc6cdf1891c961f23eec04927.jpg",
            "author_id": 8182710
        }],
        "next_url": "https://api.spreaker.com/v2/explore/lists/108/items?last_id=1441069&limit=3"
    }
}

Retrieving a Category’s items

GET /v2/explore/categories/CATEGORY-ID/items

This API returns a paginated list of items. The list items’ sorting is based on an internal ranking algorithm that pushes the most popular and highest quality content to the top of the list.

Example

curl 'https://api.spreaker.com/v2/explore/categories/14/items?limit=3'
{
    "response": {
        "items": [
            {
                "show_id": 1537596,
                "title": "Game Scoop!",
                "site_url": "https://www.spreaker.com/show/ign-games-podcasts",
                "image_url": "https://d1bm3dmew779uf.cloudfront.net/large/96c1824a3f8a0f984f9bd1666f32866c.jpg",
                "image_original_url": "https://d3wo5wojvuv7l.cloudfront.net/images.spreaker.com/original/96c1824a3f8a0f984f9bd1666f32866c.jpg",
                "author_id": 8396681
            },
            {
                "show_id": 1537254,
                "title": "Giant Bombcast",
                "site_url": "https://www.spreaker.com/show/giant-bombcast",
                "image_url": "https://d1bm3dmew779uf.cloudfront.net/large/55bcd7fd1f74a0aa118950078148114f.jpg",
                "image_original_url": "https://d3wo5wojvuv7l.cloudfront.net/images.spreaker.com/original/55bcd7fd1f74a0aa118950078148114f.jpg",
                "author_id": 8395920
            },
            {
                "show_id": 1537599,
                "title": "Retronauts",
                "site_url": "https://www.spreaker.com/show/retronauts",
                "image_url": "https://d1bm3dmew779uf.cloudfront.net/large/89d6bba9663e909512478b22c2f8becf.jpg",
                "image_original_url": "https://d3wo5wojvuv7l.cloudfront.net/images.spreaker.com/original/89d6bba9663e909512478b22c2f8becf.jpg",
                "author_id": 8396683
            }
        ],
        "next_url": "https://api.spreaker.com/v2/explore/categories/14/items?last_id=1537599&limit=3"
    }
}