Build podcast curation into your own product

Five new endpoints let you create and maintain podcast and episode collections through the API:

1. Create a playlist: POST /api/v2/playlists
2. Update its name, description, visibility, or default episode/podcast view: PUT /api/v2/playlists/{id}
3. Add an episode or podcast, with optional curator notes: POST /api/v2/playlists/{id}/items
4. Update or clear an item's notes: PUT /api/v2/playlists/{id}/items/{item_id}
5. Delete an item from a playlist: DELETE /api/v2/playlists/{id}/items/{item_id}

Together with the existing playlist read endpoints, this is a step toward a complete headless CMS for podcast curation. Listen Notes manages the collections and curator notes; you decide how to present them in your website or app. Editors can curate in Listen Later or through your own interface, and your application can retrieve the results through the API.

For example, you can build:

1. Editorial topic pages with handpicked podcasts and episodes, plus notes explaining why each selection matters.
2. Podcast newsletters and weekly listening guides backed by a collection that editors can keep up to date.
3. Learning and research libraries that organize episodes around a course, project, or area of interest.
4. Curated discovery experiences in your own app, with collections for different audiences or interests.

Choose public, unlisted, or private visibility for each collection. Only playlists owned by your admin API account can be modified. Keep your API key on your application's backend when building your own editing interface.

Explore the playlist endpoints and examples →

Faster testing directly in the API docs

The interactive API docs now send test requests directly from your browser. Fill in the parameter fields, select your API key, and click Run to see the real response.

The displayed code snippet is read-only and stays in sync with your inputs. Switch languages and libraries to find the example you need, then use Copy to take it into your project. Run uses the same browser request flow whichever language is displayed.

Results show the HTTP status, request duration, JSON response, and available quota, usage, API latency, and next billing date headers. You can also select the mock server to try requests with sample data. Running a write endpoint against the real API changes your account's data.

Endpoint groups are now collapsible, making it easier to focus on the endpoint you're exploring.

A new OpenAPI explorer

Our new OpenAPI HTML explorer, powered by Scalar, offers another way to browse endpoints, inspect parameters and schemas, and try requests. When you're signed in and have API keys, you can select a key to test requests directly in the explorer.

We've also simplified the Markdown API reference: it keeps the full reference and data examples, with links to SDK method documentation instead of long executable code samples.

Updated SDKs across all supported languages

The updated SDKs support the new playlist operations, with refreshed dependencies, examples, and tests. Find installation instructions and method examples for each language:

1. JavaScript / Node.js / Cloudflare Workers — 3.0.2
2. Python — 3.0.0
3. Ruby — 3.0.0
4. PHP — 3.0.0
5. Rust — 3.0.0
6. Go — v3.0.0
7. Swift — 3.0.0
8. .NET — 3.0.0
9. Java — 3.0.0
10. Kotlin — updated examples using Java SDK 3.0.0
11. Scala — updated examples using Java SDK 3.0.0

Check the linked READMEs for each SDK's runtime requirements and upgrade instructions. Kotlin and Scala use the shared Java SDK.

Our Podcast API skill for AI coding agents, llms.txt, and full agent reference now cover these SDK versions and the playlist curation workflow, too.

Listen Notes supports Facebook, Google, and Twitter for social login, alongside signing in with your email address or a passkey.

To add, disconnect, or change your connected social accounts, open Settings and select the ACCOUNT tab.

The Manager role lets you delegate everyday team management:

1) API and Premium Membership: Managers can add team members and update payment methods.

2) Database subscriptions: Managers can add team members.

This reduces the workload for Admins by letting Managers help onboard teammates and, for API and Premium Membership, manage billing.

To change a team member’s role, open the TEAM tab in your API dashboard or Premium Membership page, or visit your Database subscription page.

AI agents, scripts, and other programs can now fetch the latest podcast industry stats, including the total number of podcasts, total number of episodes, and every raw-number table on the page.

Markdown: https://www.listennotes.com/podcast-stats.md

JSON: https://www.listennotes.com/podcast-stats.json

The interactive stats page is still available at: https://www.listennotes.com/podcast-stats/

Now, you can search for a podcast directly on Listen411, browse its episodes from newest to oldest (or oldest to newest), and select multiple episodes for one purchase order. Episodes you have already transcribed stay visible and link to their transcripts, making it easy to avoid duplicates.

Try it now: https://www.listen411.com/

Explore the updated charts here: https://www.listennotes.com/podcast-stats/

Highlights:

• See what percentage of new podcasts are AI-generated “slop”.
• Easily download charts as images for sharing and presentations.

Check out the latest podcast industry trends and insights!

The core idea remains the same: make it easy to discover and share great moments from podcasts.

Try the new experience: https://www.listennotes.com/clips/

Now, you can add multiple files to the same purchase order. Simply paste a batch of audio or video URLs, place one order, and receive all your transcripts at the fastest available speed.

Try it now: https://www.listen411.com/

React 17 was released in 2020—nearly six years ago. As a rule of thumb, we try not to leave critical infrastructure, libraries, or frameworks on outdated versions for too long. The longer an upgrade is postponed, the more difficult it can become as technical debt compounds. Staying current (but not the newest version!) also helps us benefit from the latest security patches, performance improvements, and new features.

The upgrade went smoothly. We completed extensive end-to-end testing across all user-facing features on the website.

Hopefully, the next React upgrade won’t have to wait another six years. :)

The website UI is now available in 30 non-English languages.

Our last major internationalization update was before COVID, so this refresh was long overdue!

You can now use an emoji as your Playlist image or Profile image, making it easier to personalize your account with just a few clicks.

Why use a Passkey?

Passkeys let you sign in to Listen Notes with your device unlock, such as Touch ID, Face ID, Windows Hello, a phone screen lock, or a security key. They are easier than login links and more resistant to phishing. You can save them with tools such as Apple iCloud Keychain, Google Password Manager, 1Password, or a FIDO2 security key. Learn more about passkeys.

How to add a Passkey?

Go to the Passkeys tab in your account settings:

https://www.listennotes.com/settings/#passkey

From there, you can add one or more passkeys to your account.

And when you log in next time, you can click the "Continue with Passkey" to use your passkey to log in.

GitHub repo: github.com/PodcastAPI/skills

Why use it?

Instead of making your coding agent guess:

• How Podcast API authentication works
• Which endpoints to use
• Pagination patterns
• Search vs. lookup workflows
• Common implementation mistakes

The skill provides agent-friendly guidance, examples, and best practices out of the box. It helps agents generate more accurate code and spend less time hallucinating API usage.

Works with

• OpenAI Codex
• Claude Code
• Any CLI coding agent that supports agent skills / context injection

Typical use cases

Ask your coding agent things like:

• “Build a podcast search app with Podcast API.”
• “Find podcast episodes mentioning Nvidia earnings.”
• “Create a daily podcast monitoring workflow.”
• “Build a podcast recommendation feature.”
• “Generate TypeScript code for Podcast API search.”

The agent will automatically use the skill instructions to choose the right endpoints and implementation patterns.

You can learn how to integrate with popular coding agents like Codex and Claude Code at https://github.com/PodcastAPI/skills#install

Feedback welcome

If your coding agent makes mistakes or you find missing examples, please open an issue or PR. We’ll continue improving the skill as Podcast API evolves.

We also improved our re-indexing pipeline, making it 4× faster than before. As a result, we can now re-index the entire podcast database in under 24 hours.

In addition, we re-provisioned the Elasticsearch cluster using newer storage-optimized EC2 instances, delivering better performance while reducing infrastructure costs.

Although Stripe deprecated this checkout experience in 2019, it continued to work reliably for us, so we kept using it for several more years - well, it's 7+ years!

This is what the old checkout modal looked like:

Last week, we completed a major migration to Stripe’s modern Payment Element-based checkout.

This migration not only removes our dependency on deprecated Stripe technology, but also brings several improvements behind the scenes, including:

• Support for 3D Secure (3DS) authentication when required
• Improved fraud detection and payment security
• Better compatibility with modern payment methods
• Ongoing support and updates from Stripe

This is what the new checkout experience looks like:

In addition to credit card payments through Stripe, we also support Google Pay, Apple Pay, and PayPal.

As always, if you run into any payment issues or have feedback about the new checkout experience, please let us know: hello@listennotes.com

We’ve just added support for Latest Episodes! This is a game-changer for podcast networks or curators who want a single, dynamic widget that automatically updates with the freshest content across multiple curated podcasts.

How to enable it:

1) Open your playlist and head over to the EMBED tab.

2) Under the Item type dropdown, select "Latest episodes."

4) Copy your embed code.

With this update, you can now manage your playback (play, pause, and seek) directly from your device's lock screen or notification center, providing a more seamless listening experience on the go.

The demo site is hosted on Cloudflare Pages.

The entire source code for this demo is available on GitHub at ListenNotes/demo.podcastapi.com. We encourage you to fork the repo, experiment with the implementation, and use it as a foundation for your own projects.

Check out the new UI below:

Whether you are using ChatGPT, Claude, or any other LLM, you can now simply copy-paste the entire documentation to give the AI full context. This allows your favorite AI assistant to help you write, debug, and optimize your code with perfect accuracy.

You can also find the markdown file at https://www.listennotes.com/api/docs/: