Dark mode

Introduction

Welcome to the Aonsoku Podcast Management API documentation. This API provides a comprehensive set of endpoints for managing podcasts and their episodes, allowing you to create, retrieve, update, and delete podcast records, as well as perform searches and save episode listening progress.

Was this section helpful?

What made this section unhelpful for you?

Base URL

Sandbox:

http://aonsoku-podcast.test

Localhost:

http://localhost:8000

Language Box

Authentication

This section guides users on how to access and authenticate their accounts to perform various actions using the API.

The Username and Server URL values do not need to be manually created. After the first request using the credentials listed below, the API will automatically create the user for you.

Name
Header
Description
Required

Username

APP-USERNAME

Your subsonic username.

Server URL

APP-SERVER-URL

Your subsonic server URL.

If either of these headers is not provided, the server will respond with a 400 Bad Request status.

Was this section helpful?

What made this section unhelpful for you?

Episode updates

The API automatically searches for new episodes periodically (every 2 hours), and to minimize CPU usage, it skips episodes that have already been processed. Users can stay up-to-date with the most recent content effortless.

Was this section helpful?

What made this section unhelpful for you?

Podcasts

This section allows users to access detailed information about podcasts, including titles, descriptions, release dates, and more.

Endpoints

GET
GET
POST
POST
GET
DELETE

Episodes

This section allows users to access detailed information about podcast episodes. Users can retrieve episode titles, descriptions, release dates, and more.

Endpoints

GET
GET
GET
PATCH