aonsoku

Getting Started

Introduction

Authentication

Episode updates

API Reference

Podcasts

Episodes

Default

Aonsoku Podcasts

Sandbox

Localhost

<p class="slate-p " >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.</p><p class="slate-p " ></p>

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.

Tab 1

<p class="slate-p " >This section guides users on how to access and authenticate their accounts to perform various actions using the API.</p><p class="slate-p " >The <code class="slate-code">Username</code> and <code class="slate-code">Server URL</code> 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.</p><h2 class="slate-h2 " ></h2><div class="table-container" style="width:98%;
  min-width:98%;"><table class="slate-table" ><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:400px;">Name</div><div style="width:400px;">Header</div><div style="width:400px;">Description</div><div style="width:400px;">Required</div></div><colgroup ></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Username</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >APP-USERNAME</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Your subsonic username.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >✅</p></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Server URL</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >APP-SERVER-URL</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >Your subsonic server URL.</p></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><p class="slate-p " >✅</p></td></div></tr></tbody></table></div><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=error ><div class="callout-icon"><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M9.08366 9.9801C9.25033 9.9801 9.39269 9.92107 9.51074 9.80302C9.6288 9.68496 9.68783 9.53566 9.68783 9.3551V5.31344C9.68783 5.14677 9.62533 5.00441 9.50033 4.88635C9.37533 4.7683 9.22949 4.70927 9.06283 4.70927C8.88227 4.70927 8.73296 4.7683 8.61491 4.88635C8.49685 5.00441 8.43783 5.15371 8.43783 5.33427V9.37594C8.43783 9.5426 8.50033 9.68496 8.62533 9.80302C8.75033 9.92107 8.9031 9.9801 9.08366 9.9801ZM9.00033 13.1676C9.19477 13.1676 9.35796 13.1016 9.48991 12.9697C9.62185 12.8377 9.68783 12.6745 9.68783 12.4801C9.68783 12.2857 9.62185 12.1225 9.48991 11.9905C9.35796 11.8586 9.19477 11.7926 9.00033 11.7926C8.80588 11.7926 8.64269 11.8586 8.51074 11.9905C8.3788 12.1225 8.31283 12.2857 8.31283 12.4801C8.31283 12.6745 8.3788 12.8377 8.51074 12.9697C8.64269 13.1016 8.80588 13.1676 9.00033 13.1676ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C10.9448 16.0843 12.6114 15.3898 14.0003 14.0009C15.3892 12.612 16.0837 10.9454 16.0837 9.00094C16.0837 7.05649 15.3892 5.38982 14.0003 4.00094C12.6114 2.61205 10.9448 1.9176 9.00033 1.9176C7.05588 1.9176 5.38921 2.61205 4.00033 4.00094C2.61144 5.38982 1.91699 7.05649 1.91699 9.00094C1.91699 10.9454 2.61144 12.612 4.00033 14.0009C5.38921 15.3898 7.05588 16.0843 9.00033 16.0843Z" fill="#E90005"></path></svg></div><div ><p class="slate-p " >If either of these headers is not provided, the server will respond with a <code class="slate-code">400 Bad Request</code> status.</p></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

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

 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

<p class="slate-p " >The API automatically searches for new episodes periodically <em class="slate-italic">(every 2 hours), </em>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.</p><p class="slate-p " ></p>

The API automatically searches for new episodes periodically 

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.

<p class="slate-p " >This section allows users to access detailed information about podcasts, including titles, descriptions, release dates, and more.</p><p class="slate-p " ></p><p class="slate-p " ></p>

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

<p class="slate-p " >This section allows users to access detailed information about podcast episodes. Users can retrieve episode titles, descriptions, release dates, and more.</p><p class="slate-p " ></p>

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

Sections