Listen Notes

Listen Notes runs the largest podcast search engine and database, and exposes it as the Listen API - a simple, no-nonsense podcast search, directory, and insights REST API. It lets developers full-text search millions of podcasts and episodes by people, places, and topics; fetch podcast and episode metadata; browse best-podcasts charts, curated lists, and genres; retrieve podcast/episode recommendations; power typeahead autocomplete; and pull audience demographics and publisher-domain insights. The API is served at https://listen-api.listennotes.com/api/v2 and authenticated with an X-ListenAPI-Key header, with FREE, PRO, and ENTERPRISE plans billed on a request basis.

12 APIs 0 Features
PodcastsPodcast SearchPodcast DirectorySearchAudioMediaPodcast Insights

APIs

Listen Notes Search API

Full-text search across episodes, podcasts, and curated lists by people, places, or topics, with rich filters (genre, language, region, length, publish date, episode count, upda...

Listen Notes Typeahead API

Typeahead search that suggests search terms, podcasts, and genres as a user types - ideal for building autocomplete boxes for podcast search interfaces.

Listen Notes Trending & Related Searches API

Fetch trending search terms across the platform and related search terms for a given query, useful for surfacing popular topics and expanding discovery.

Listen Notes Podcasts API

Fetch detailed metadata and paginated episodes for a podcast by id, batch fetch basic metadata for multiple podcasts by id, and pull a random podcast episode (Just Listen) for s...

Listen Notes Episodes API

Fetch detailed metadata for a single episode by id, and batch fetch basic metadata for multiple episodes by id in one request.

Listen Notes Best Podcasts API

Fetch curated best-podcasts charts by genre, region, publisher region, and language - the editorial and popularity-ranked lists that power podcast discovery experiences.

Listen Notes Curated Lists API

Fetch paginated curated lists of podcasts hand-assembled around themes and topics from around the web, and retrieve the podcasts inside a specific curated list by id.

Listen Notes Playlists API

Fetch your Listen Later playlists and the items (episodes or podcasts) inside a specific playlist by id, letting apps read the playlists a user builds on Listen Notes.

Listen Notes Genres, Regions & Languages API

Fetch the reference vocabularies used across the API - the full podcast genre taxonomy, the supported countries/regions for best-podcasts charts, and the supported podcast langu...

Listen Notes Recommendations API

Fetch similar-content recommendations for a given podcast or a given episode, powering "you might also like" discovery surfaces.

Listen Notes Podcast Audience Insights API

Fetch audience demographics and insights for a podcast by id, and list the podcasts associated with a publisher's domain name - the analytics surface for understanding a show's ...

Listen Notes Podcaster API

Endpoints for podcasters to improve the Listen Notes database - submit a podcast by RSS URL, force a refresh of a podcast's RSS feed, and request removal of a podcast.

Collections

Listen API (Listen Notes)

OPEN

Pricing Plans

Listennotes Plans Pricing

3 plans

PLANS

Rate Limits

Listennotes Rate Limits

8 limits

RATE LIMITS

FinOps

Listennotes Finops

FINOPS

Resources

🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Listen API (Listen Notes)
  version: '2.0'
request:
  auth:
    type: apikey
    apikey:
      key: X-ListenAPI-Key
      value: '{{apiKey}}'
      in: header
items:
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Full-text search
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/search
      params:
      - name: q
        value: star wars
        type: query
      - name: type
        value: episode
        type: query
    docs: Full-text search on episodes, podcasts, or curated lists by people, places, or topics.
  - info:
      name: Typeahead search
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/typeahead
      params:
      - name: q
        value: star
        type: query
      - name: show_podcasts
        value: '1'
        type: query
    docs: Suggest search terms, podcasts, and genres for autocomplete.
  - info:
      name: Search episode titles
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/search_episode_titles
      params:
      - name: q
        value: star wars
        type: query
    docs: Find individual episodes by searching their titles.
  - info:
      name: Trending searches
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/trending_searches
    docs: Fetch trending search terms.
  - info:
      name: Related searches
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/related_searches
      params:
      - name: q
        value: star wars
        type: query
    docs: Fetch related search terms for a query.
  - info:
      name: Spell check
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/spellcheck
      params:
      - name: q
        value: star warz
        type: query
    docs: Suggest a spell-corrected version of a search term.
- info:
    name: Podcasts
    type: folder
  items:
  - info:
      name: Get a podcast by id
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/podcasts/:id
      params:
      - name: id
        value: ''
        type: path
        description: Podcast id.
    docs: Fetch detailed metadata and episodes for a podcast by id.
  - info:
      name: Batch fetch podcasts
      type: http
    http:
      method: POST
      url: https://listen-api.listennotes.com/api/v2/podcasts
      body:
        type: urlencoded
        data: ids=
    docs: Batch fetch basic metadata for up to 10 podcasts by id.
  - info:
      name: Just Listen (random episode)
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/just_listen
    docs: Fetch a random podcast episode.
- info:
    name: Episodes
    type: folder
  items:
  - info:
      name: Get an episode by id
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/episodes/:id
      params:
      - name: id
        value: ''
        type: path
        description: Episode id.
    docs: Fetch detailed metadata for an episode by id.
  - info:
      name: Batch fetch episodes
      type: http
    http:
      method: POST
      url: https://listen-api.listennotes.com/api/v2/episodes
      body:
        type: urlencoded
        data: ids=
    docs: Batch fetch basic metadata for up to 10 episodes by id.
- info:
    name: Best Podcasts & Curated Lists
    type: folder
  items:
  - info:
      name: Best podcasts by genre
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/best_podcasts
      params:
      - name: genre_id
        value: '93'
        type: query
      - name: region
        value: us
        type: query
    docs: Fetch best-podcasts charts by genre and region.
  - info:
      name: Fetch curated lists
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/curated_podcasts
      params:
      - name: page
        value: '1'
        type: query
    docs: Fetch curated lists of podcasts.
  - info:
      name: Get a curated list by id
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/curated_podcasts/:id
      params:
      - name: id
        value: ''
        type: path
        description: Curated list id.
    docs: Fetch a curated list of podcasts by id.
- info:
    name: Genres, Regions & Languages
    type: folder
  items:
  - info:
      name: Fetch genres
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/genres
      params:
      - name: top_level_only
        value: '0'
        type: query
    docs: Fetch the podcast genre taxonomy.
  - info:
      name: Fetch regions
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/regions
    docs: Fetch supported countries/regions for best-podcasts charts.
  - info:
      name: Fetch languages
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/languages
    docs: Fetch supported languages for podcasts.
- info:
    name: Recommendations
    type: folder
  items:
  - info:
      name: Podcast recommendations
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/podcasts/:id/recommendations
      params:
      - name: id
        value: ''
        type: path
        description: Podcast id.
    docs: Fetch recommendations for a podcast.
  - info:
      name: Episode recommendations
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/episodes/:id/recommendations
      params:
      - name: id
        value: ''
        type: path
        description: Episode id.
    docs: Fetch recommendations for an episode.
- info:
    name: Playlists
    type: folder
  items:
  - info:
      name: Fetch your playlists
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/playlists
      params:
      - name: page
        value: '1'
        type: query
    docs: Fetch a list of your Listen Later playlists.
  - info:
      name: Get a playlist by id
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/playlists/:id
      params:
      - name: id
        value: ''
        type: path
        description: Playlist id.
    docs: Fetch a playlist's info and items.
- info:
    name: Insights
    type: folder
  items:
  - info:
      name: Podcast audience demographics
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/podcasts/:id/audience
      params:
      - name: id
        value: ''
        type: path
        description: Podcast id.
    docs: Fetch audience demographics for a podcast.
  - info:
      name: Podcasts by publisher domain
      type: http
    http:
      method: GET
      url: https://listen-api.listennotes.com/api/v2/podcasts/domains/:domain_name
      params:
      - name: domain_name
        value: nytimes.com
        type: path
        description: Publisher domain name.
      - name: page
        value: '1'
        type: query
    docs: Fetch podcasts associated with a publisher's domain name.
- info:
    name: Podcaster
    type: folder
  items:
  - info:
      name: Submit a podcast
      type: http
    http:
      method: POST
      url: https://listen-api.listennotes.com/api/v2/podcasts/submit
      body:
        type: urlencoded
        data: rss=&email=
    docs: Submit a podcast to the Listen Notes database by RSS URL.
  - info:
      name: Refresh a podcast RSS feed
      type: http
    http:
      method: POST
      url: https://listen-api.listennotes.com/api/v2/podcasts/:id/rss
      params:
      - name: id
        value: ''
        type: path
        description: Podcast id.
    docs: Force a refresh of a podcast's RSS feed.
  - info:
      name: Request to delete a podcast
      type: http
    http:
      method: DELETE
      url: https://listen-api.listennotes.com/api/v2/podcasts/:id
      params:
      - name: id
        value: ''
        type: path
        description: Podcast id.
      - name: reason
        value: ''
        type: query
    docs: Request removal of a podcast from the database.