Module listennotes

ballerinax/listennotes Ballerina library

1.0.0

Overview

The Listen Notes connector lets Ballerina applications search and explore podcasts and episodes, and manage playlists, through the Listen API. It supports version 2.0 of the API.

Key features

  • Search podcasts, episodes and curated lists, with typeahead suggestions, trending searches and related terms
  • Browse the podcast directory by genre, region and language, and fetch curated lists of podcasts
  • Retrieve detailed metadata for podcasts and episodes, individually or in batches
  • Get podcast and episode recommendations and look up audience demographics
  • Create and manage playlists of episodes and podcasts, and submit new podcasts to the database

Setup guide

To use the connector, you need a Listen API key.

  1. Create an account at Listen Notes and sign in.

  2. Open the API dashboard and choose a plan. A free plan is available for trying out the API.

  3. Copy your API key from the dashboard. Team keys act as the API admin.

Quickstart

To use the Listen Notes connector in your Ballerina application, update the .bal file as follows:

Step 1: Import the module

Copy
import ballerinax/listennotes;

Step 2: Create a Config.toml file

Copy
apiKey = "<Listen API key>"

Step 3: Create a client

Copy
configurable string apiKey = ?;

final listennotes:Client listenNotes = check new ({xListenAPIKey: apiKey});

Step 4: Invoke an operation

Copy
public function main() returns error? {
    listennotes:TrendingSearchesResponse _ = check listenNotes->getTrendingSearches();
}

Examples

The Listen Notes connector provides practical examples illustrating usage in various scenarios. Explore these examples, covering the following use cases:

  1. Genre podcast report - Finds the best podcasts in a genre and lists the most recent episodes of each.
  2. Podcast playlist builder - Searches for episodes on a topic, collects them in a new playlist and reads the playlist back.

Import

import ballerinax/listennotes;Copy

Other versions

1.0.0

Metadata

Released date: 1 day ago

Version: 1.0.0

License: Apache-2.0


Security

Direct vulnerabilities: No known direct vulnerabilities

Indirect vulnerabilities: 

Checked on 2026-11-21 via OSV.dev


Compatibility

Platform: any

Ballerina version: 2201.12.0

GraalVM compatible: Yes


Pull count

Total: 1

Current verison: 1


Weekly downloads


Source repository


Keywords

Vendor/Listen Notes

Area/Communication

Type/Connector


Contributors