My Pod API

Getting Started

My Pod allows you to access your account via a RESTful API.

Please note that an active paid My Pod subscription is required in order to use the My Pod API.

You will need to generate an API key. You can do this in your account settings page. Click on the API Keys tab and generate and copy your API key.

All requests must supply the following HTTP header:

x-mypod-key: <api key>
API Endpoints
Playlists
  • Create Playlist
    PUT https://mypodapp.com/api/playlist

    Creates a new Playlist.

    Request:
{
    "name":"My new playlist"
}

Response:
201 CREATED
{
    "id": "84022441-1e8f-425d-a2be-32f4b71ba708",
    "name": "My new playlist"
}
  • Delete Playlist
    DELETE https://mypodapp.com/api/playlist/<playlistid>

    Deletes a Playlist.

    Response:
200 OK
  • Update Playlist
    POST https://mypodapp.com/api/playlist/<playlistid>

    Updates an existing Playlist.

    Request:
{
    "name":"My new playlist"
}

Response:
200 OK
  • Update Playlist Order / Position
    POST https://mypodapp.com/api/playlist/reorder/<playlistid>/<relativeorder>

    Updates an existing Playlists relative order.

    Note: relative order should be an integer.

Response:
200 OK
  • List Playlists
    GET https://mypodapp.com/api/playlist

    Retrieves a list of playlists.

    Response:
200 OK
[
    {
        "id": "f3af8b52-bea5-4dbc-beb0-2da58cf5ab5f",
        "name": "My Songs",
        "createdDateTime": "2018-08-01T11:09:29",
        "lastPlayedDateTime": null,
        "updatedDateTime": "2019-12-14T08:25:04"
    },
    {
        "id": "0bf73fa3-43d3-4223-be14-3fe3f7b726d2",
        "name": "Podcasts",
        "createdDateTime": "2017-11-18T14:28:30",
        "lastPlayedDateTime": "2018-03-02T10:26:11",
        "updatedDateTime": "2019-12-14T08:25:04"
    }
]
  • Statistics
    GET https://mypodapp.com/api/playlist/<playlistid>/stats

    Retrieves usage statistics for a specified playlist.

    Response:
200 OK
{
    "linkCount": 20,
    "linkAllowance": 10,
    "linkUsagePercent": 200
}
  • Links
    GET https://mypodapp.com/api/playlist/<playlistid>/links

    Retrieves a list of links for a specified Playlist.

    Response:
200 OK
[
    {
        "id": "e12d3779-27ab-4e55-bd20-6e73a392b2c1",
        "tag": "joe rogan",
        "public": false,
        "createdDateTime": "2017-11-29T21:40:14",
        "lastPlayedDateTime": "2018-07-28T10:02:46",
        "updatedDateTime": "2020-10-04T16:12:56",
        "url": "http://joeroganexp.joerogan.libsynpro.com/rss",
        "imageUrl": "http://static.libsyn.com/p/assets/7/1/f/3/71f3014e14ef2722/JREiTunesImage2.jpg"
    },
    {
        "id": "81dce8a5-3451-4c37-971c-d2fa92fbf6e8",
        "tag": "Lore",
        "public": false,
        "createdDateTime": "2018-01-29T09:17:45",
        "lastPlayedDateTime": null,
        "updatedDateTime": "2020-10-04T16:12:56",
        "url": "http://lorepodcast.libsyn.com/rss",
        "imageUrl": "http://is3.mzstatic.com/image/thumb/Music62/v4/2d/3a/00/2d3a00e9-315f-d21c-8af2-6ff591d2f864/source/100x100bb.jpg"
    }
]
Links
  • Create Link
    PUT https://mypodapp.com/api/playlist/<playlistid>

    Creates a new Link.

    Request:
{
    "tag":"BBC News",
    "url": "https://www.bbc.co.uk",
    "username": null,
    "password": null,
    "public": false,
    "disableResume": false,
    "imageUrl": null
}

Response:
201 CREATED
[{
    "id": "33de5ac9-e08d-451b-ae44-197548232d07",
    "tag": "BBC News",
    "public": false,
    "disableResume": false,
    "createdDateTime": "2020-10-07T14:24:15.3868625Z",
    "lastPlayedDateTime": null,
    "updatedDateTime": "2020-10-07T14:24:15.3868657Z",
    "url": "https://www.bbc.co.uk/",
    "imageUrl": "https://www.bbc.co.uk/favicon.ico"
}]
  • Update Link
    POST https://mypodapp.com/api/playlist/<playlistid>/<linkid>

    Updates an existing Link.

    Request:
{
    "tag":"BBC News",
    "username": null,
    "password": null,
    "public": false,
    "disableResume": false,
}

Response:
200 OK
  • Update Link Order / Position
    POST https://mypodapp.com/api/playlist/link/<linkid>/<relativeorder>

    Updates an existing links position in a playlist.

    Note: relative order should be an integer.

Response:
200 OK
  • Delete Link
    DELETE https://mypodapp.com/api/playlist/<playlistid>/<linkid>

    Deletes an existing Link.

    Response:
200 OK