API docs by Redocly

Listen API: Podcast Search, Directory, and Insights API (2.0)

Download OpenAPI specification:

Listen Notes: hello@listennotes.com URL: https://www.listennotes.com/api/ Terms of Service

Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics.

Search API

Endpoints to search podcasts

Full-text search

Full-text search on episodes, podcasts, or curated lists of podcasts. Use the offset parameter to paginate through search results. The FREE plan allows to see up to 30 search results (or offset < 30) per query. The PRO plan allows to see up to 300 search results (or offset < 300) per query. The ENTERPRISE plan allows to see up to 10,000 search results (or offset < 10000) per query.

query Parameters
q
required
string
Example: q=star wars

Search term, e.g., person, place, topic... You can use double quotes to do verbatim match, e.g., "game of thrones". Otherwise, it's fuzzy search.

sort_by_date
integer
Default: 0
Enum: 0 1
Example: sort_by_date=0

Sort by date or not? If 0, then sort by relevance. If 1, then sort by date.

type
string
Default: "episode"
Enum: "episode" "podcast" "curated"
Example: type=episode

What type of contents do you want to search for?

offset
integer
Default: 0
Example: offset=0

Offset for search results, for pagination. You'll use next_offset from response for this parameter.

len_min
integer
Default: 0
Example: len_min=10

Minimum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it's for audio length of an episode. If type parameter is podcast, it's for average audio length of all episodes in a podcast.

len_max
integer
Example: len_max=30

Maximum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it's for audio length of an episode. If type parameter is podcast, it's for average audio length of all episodes in a podcast.

episode_count_min
integer

Minimum number of episodes. Applicable only when type parameter is podcast.

episode_count_max
integer

Maximum number of episodes. Applicable only when type parameter is podcast.

update_freq_min
integer

Minimum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find "weekly" podcasts, then you can set update_freq_min=144 hours (or 6 days) and update_freq_max=192 hours (or 8 days). Applicable only when type parameter is podcast.

update_freq_max
integer

Maximum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find "weekly" podcasts, then you can set update_freq_min=144 hours (or 6 days) and update_freq_max=192 hours (or 8 days). Applicable only when type parameter is podcast.

genre_ids
string
Example: genre_ids=68,82

A comma-delimited string of a list of genre ids. If not specified, then all genres are included. You can find the id and the name of all genres from GET /genres. It works only when type is episode or podcast.

published_before
integer
Example: published_before=1580172454000

Only show episodes/podcasts/curated lists published before this Epoch Unix timestamp (in milliseconds). If published_before & published_after are used at the same time, published_before should be bigger than published_after.

published_after
integer
Default: 0
Example: published_after=0

Only show episodes/podcasts/curated lists published after this Epoch Unix timestamp (in milliseconds). If published_before & published_after are used at the same time, published_before should be bigger than published_after.

only_in
string
Default: "title,description,author,audio"
Example: only_in=title,description

A comma-delimited string to search only in specific fields. Allowed values are title, description, author, and audio. If not specified, then search every fields.

language
string
Example: language=English

Limit search results to a specific language. If not specified, it'll be any language. You can get a list of supported languages from GET /languages. It works only when type is episode or podcast.

region
string
Example: region=

Limit search results to a specific region (e.g., us, gb, in...). If not specified, it'll be any region. You can get the supported country codes from GET /regions. It works only when type is episode or podcast.

ocid
string

A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the podcast_id field in response. This parameter is to limit search results from only a few specific podcasts. It works only when type is episode.

ncid
string

A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the podcast_id field in response. This parameter is to exclude search results of a few specific podcasts. It works only when type is episode.

safe_mode
integer
Default: 0
Enum: 0 1
Example: safe_mode=0

Whether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. It works only when type is episode or podcast.

unique_podcasts
integer
Default: 0
Enum: 0 1
Example: unique_podcasts=0

Whether or not to keep only one episode per podcast in search results. 1 is yes and 0 is no. It works only when type is episode.

interviews_only
integer
Default: 0
Enum: 0 1
Example: interviews_only=0

Whether or not to keep only podcasts that have guest interviews in search results. 1 is yes and 0 is no. It works only when type is podcast. This parameter is available only in the PRO/ENTERPRISE plan.

sponsored_only
integer
Default: 0
Enum: 0 1
Example: sponsored_only=0

Whether or not to keep only podcasts that have sponsors in search results. 1 is yes and 0 is no. It works only when type is podcast. This parameter is available only in the PRO/ENTERPRISE plan.

page_size
integer
Default: 10
Example: page_size=10

The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive).

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "next_offset": 10,
  • "took": 0.093,
  • "total": 1989,
  • "count": 10,
  • "results": [
    ]
}

Typeahead search

Suggest search terms, podcast genres, and podcasts.

query Parameters
q
required
string
Example: q=star wars

Search term, e.g., person, place, topic... You can use double quotes to do verbatim match, e.g., "game of thrones". Otherwise, it's fuzzy search.

show_podcasts
integer
Default: 0
Enum: 0 1
Example: show_podcasts=1

Autosuggest podcasts. This only searches podcast title and publisher and returns very limited info of 5 podcasts. 1 is yes, 0 is no. It's a bit slow to autosuggest podcasts, so we turn it off by default. If show_podcasts=1, you can also pass iTunes id (e.g., 474722933) to the q parameter to fetch podcast meta data.

show_genres
integer
Default: 0
Enum: 0 1
Example: show_genres=1

Whether or not to autosuggest genres. 1 is yes, 0 is no.

safe_mode
integer
Default: 0
Enum: 0 1
Example: safe_mode=0

Whether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. It works only when show_podcasts is 1.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Find individual episodes by searching for their titles

Conduct targeted searches for individual episodes by title and refine results using the podcast id such as Listen Notes Podcast ID, Apple Podcasts ID, Spotify ID, or RSS feed URL. This endpoint is specially designed to streamline the import of specific episodes from platforms like Apple Podcasts and Spotify into your application. Compared to the GET /search endpoint, which performs full-text searches across multiple fields, this endpoint focuses solely on episode titles for enhanced accuracy and performance.

query Parameters
q
required
string
Example: q=Jerusalem Demsas on The Dispossessed

An episode's title, e.g., Jerusalem Demsas on The Dispossessed. You can use double quotes to do verbatim match, e.g., "Jerusalem Demsas on The Dispossessed". Otherwise, it's fuzzy search.

podcast_id
string

Refine search results by specifying a podcast through its unique ID. The format of the podcast ID is governed by the podcast_id_type parameter. For listennotes_id, the podcast ID will look like 'cda18f20f1be4ac7b3cce7d0eb168fff'. For itunes_id, it will be a numerical value like '983795625'. For spotify_id, expect a format like '0Z1234tGXD2hVhjFrrhJ7g'. For rss, the podcast ID will be the RSS URL, e.g., 'https://cowenconvos.libsyn.com/rss'.

podcast_id_type
string
Default: "listennotes_id"
Enum: "listennotes_id" "itunes_id" "spotify_id" "rss"

The type of podcast id. Valid values are listennotes_id, itunes_id, spotify_id, and rss. Note: itunes_id is for Apple Podcasts.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "next_offset": 10,
  • "took": 0.093,
  • "total": 1989,
  • "count": 10,
  • "results": [
    ]
}

Fetch trending search terms

Fetch up to 10 most recent trending search terms on the Listen Notes platform.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "terms": [
    ]
}

Fetch related search terms

Suggest related search terms. The results are more comprehensive than from GET /typeahead. This endpoint is available only in the PRO/ENTERPRISE plan.

query Parameters
q
required
string
Example: q=evergrande

Search term, e.g., person, place, topic...

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "terms": [
    ]
}

Spell check on a search term

Suggest a list of words that correct the spelling errors of a search term. This endpoint is available only in the PRO/ENTERPRISE plan.

query Parameters
q
required
string
Example: q=microsft stock

Search term, e.g., person, place, topic...

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "tokens": [
    ],
  • "corrected_text_html": "<b><i>evergrande</i></b> stock"
}

Directory API

Endpoints to fetch podcasts data

Fetch a list of best podcasts by genre

Get a list of curated best podcasts by genre, which are curated by Listen Notes staffs based on various signals from the Internet, e.g., top charts on other podcast platforms, recommendations from mainstream media, user activities on listennotes.com... You can get the genre ids from GET /genres endpoint. This endpoint returns same data as https://www.listennotes.com/best-podcasts/

query Parameters
genre_id
string
Example: genre_id=93

You can get the id from GET /genres. If not specified, it'll be the overall best podcasts, which can be considered as a special genre.

page
integer
Example: page=2

Page number of those podcasts in this genre.

region
string
Default: "us"
Example: region=us

Filter best podcasts by country/region. Please note that podcasts that are "best" in a country/region may not be produced in that country/region. For example, a podcast from the US may be very popular in Canada. You can get the supported country codes (e.g., us, jp, gb...) from GET /regions. If not specified, you'll get "best podcasts" in United States.

publisher_region
string

Filter best podcasts by the publisher's country/region. This is to narrow down the results to include "best podcasts" produced in a specific country/region. You can get the supported country codes (e.g., us, jp, gb...) from GET /regions. If not specified, you'll get "best podcasts" produced in any country/region. If you want to get a country/region's "best podcasts" that are also produced in that country/region, then you need to specify both region and publisher_region, e.g., region=jp and publisher_region=jp.

language
string

Filter best podcasts by language. You can get a list of supported languages (e.g., English, Chinese, Japanese...) from GET /languages. If not specified, you'll get "best podcasts" in any language.

sort
string
Default: "recent_added_first"
Enum: "recent_added_first" "oldest_added_first" "recent_published_first" "oldest_published_first" "listen_score"
Example: sort=listen_score

How do you want to sort these podcasts? If you'd like to sort by popularity, please use listen_score.

safe_mode
integer
Default: 0
Enum: 0 1
Example: safe_mode=0

Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Fetch detailed meta data and episodes for a podcast by id

Fetch detailed meta data and episodes for a specific podcast (up to 10 episodes each time). You can use the next_episode_pub_date parameter to do pagination and fetch more episodes. During pagination with next_episode_pub_date, an empty episodes array in the response signals that no more episodes are available.

path Parameters
id
required
string
Example: 4d3fe717742d4963a85562e9f84d8c79

Podcast id. You can get podcast id from using other endpoints, e.g., GET /search, GET /best_podcasts...

query Parameters
next_episode_pub_date
integer
Example: next_episode_pub_date=1479154463000

For episodes pagination. It's the value of next_episode_pub_date from the response of last request. If not specified, just return latest 10 episodes or oldest 10 episodes, depending on the value of the sort parameter. It is an Epoch Unix timestamp in milliseconds. During pagination with next_episode_pub_date, an empty episodes array in the response signals that no more episodes are available.

sort
string
Default: "recent_first"
Enum: "recent_first" "oldest_first"
Example: sort=recent_first

How do you want to sort the episodes of this podcast?

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Fetch detailed meta data for an episode by id

Fetch detailed meta data for a specific episode.

path Parameters
id
required
string
Example: 6b6d65930c5a4f71b254465871fed370

id for a specific episode. You can get episode id from using other endpoints, e.g., GET /search...

query Parameters
show_transcript
integer
Default: 0
Example: show_transcript=1

To include the transcript of this episode or not? If it is 1, then include the transcript in the transcript field. The default value is 0 - we don't include transcript by default, because 1) it would make the response data very big, thus slow response time; 2) less than 1% of episodes have transcripts. The transcript field is available only in the PRO/ENTERPRISE plan.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Batch fetch basic meta data for episodes

Batch fetch basic meta data for up to 10 episodes. This endpoint could be used to implement custom playlists for individual episodes. For detailed meta data of an individual episode, you need to use GET /episodes/{id}. This endpoint is available only in the PRO/ENTERPRISE plan.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Request Body schema: application/x-www-form-urlencoded
required
ids
required
string

Comma-separated list of episode ids.

Responses

Response samples

Content type
application/json
{}

Batch fetch basic meta data for podcasts

Batch fetch basic meta data for up to 10 podcasts. This endpoint could be used to build something like OPML import, allowing users to import a bunch of podcasts via rss urls. For detailed meta data (including episodes) of an individual podcast, you need to use GET /podcasts/{id}. This endpoint is available only in the PRO/ENTERPRISE plan.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Request Body schema: application/x-www-form-urlencoded
optional
ids
string

Comma-separated list of podcast ids.

rsses
string

Comma-separated rss urls.

itunes_ids
string

Comma-separated Apple Podcasts (iTunes) ids, e.g., 659155419

spotify_ids
string

Comma-separated Spotify ids, e.g., 3DDfEsKDIDrTlnPOiG4ZF4

show_latest_episodes
integer
Default: 0
Enum: 0 1

Whether or not to fetch up to 15 latest episodes from these podcasts, sorted by pub_date. 1 is yes, and 0 is no.

next_episode_pub_date
integer

For latest episodes pagination. It's the value of next_episode_pub_date from the response of last request. If not specified, just return latest 15 episodes. It is an Epoch Unix timestamp in milliseconds.

Responses

Response samples

Content type
application/json
{}

Fetch a curated list of podcasts by id

Get detailed meta data of all podcasts in a specific curated list. This endpoint returns same data as https://www.listennotes.com/curated-podcasts/

path Parameters
id
required
string
Example: SDFKduyJ47r

id for a specific curated list of podcasts. You can get the id from the response of GET /search?type=curated or GET /curated_podcasts.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Fetch a list of podcast genres

Get a list of podcast genres that are supported in Listen Notes. The genre id can be passed to other endpoints as a parameter to get podcasts in a specific genre, e.g., GET /best_podcasts, GET /search... You may want to cache the list of genres on the client side.

query Parameters
top_level_only
integer
Default: 0
Enum: 0 1
Example: top_level_only=1

Just show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "genres": [
    ]
}

Fetch a list of supported countries/regions for best podcasts

It returns a dictionary of country codes (e.g., us, gb...) & country names (United States, United Kingdom...). The country code is used in the query parameter region of GET /best_podcasts.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "regions": {
    }
}

Fetch a list of supported languages for podcasts

Get a list of languages that are supported in Listen Notes database. You can use the language string as query parameter in GET /search.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "languages": [
    ]
}

Fetch a random podcast episode

Recently published episodes are more likely to be fetched. Good luck!

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Fetch curated lists of podcasts

A bunch of curated lists from online media. For each list, you'll get basic info of up to 5 podcasts. To get detailed meta data of all podcasts in a specific list, you need to use GET /curated_podcasts/{id}. We add new curated lists to the database on a daily basis.

query Parameters
page
integer
Default: 1
Example: page=2

Page number of curated lists.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Fetch recommendations for a podcast

Fetch up to 8 podcast recommendations based on the given podcast id.

path Parameters
id
required
string
Example: 25212ac3c53240a880dd5032e547047b

Podcast id.

query Parameters
safe_mode
integer
Default: 0
Enum: 0 1
Example: safe_mode=0

Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Fetch recommendations for an episode

Fetch up to 8 episode recommendations based on the given episode id.

path Parameters
id
required
string
Example: 254444fa6cf64a43a95292a70eb6869b

Episode id.

query Parameters
safe_mode
integer
Default: 0
Enum: 0 1
Example: safe_mode=0

Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Playlist API

Endpoints to fetch Listen Later playlists data

Fetch a playlist's info and items (i.e., episodes or podcasts).

A playlist can be an episode list (i.e., all items are episodes) or a podcast list (i.e., all items are podcasts), which is essentially the same as those created via listennotes.com/listen/. This endpoint fetches a list of items (i.e., episodes or podcasts) in the playlist. You can use the last_pub_date_ms parameter to do pagination and fetch more items. A playlist can be public (discoverable on ListenNotes.com), unlisted (accessible to anyone who knows the playlist id), or private (accessible to its owner). You can fetch all playlists created by you, and public / unlisted playlists created by others.

path Parameters
id
required
string
Example: m1pe7z60bsw

Playlist id (always 11 characters, e.g., m1pe7z60bsw). You can get the podcast id from the url of a playlist, e.g., m1pe7z60bsw is the playlist id of listennotes.com/listen/podcasts-about-podcasting-m1pe7z60bsw

query Parameters
type
string
Default: "episode_list"
Enum: "episode_list" "podcast_list"
Example: type=episode_list

The type of this playlist, which should be either episode_list or podcast_list.

last_timestamp_ms
integer
Default: 0
Example: last_timestamp_ms=0

For playlist items pagination. It's the value of last_timestamp_ms from the response of last request. If it's 0 or not specified, just return the latest or the oldest 20 items, depending on the value of the sort parameter. It is an Epoch Unix timestamp in milliseconds.

sort
string
Default: "recent_added_first"
Enum: "recent_added_first" "oldest_added_first" "recent_published_first" "oldest_published_first"
Example: sort=recent_added_first

How do you want to sort playlist items?

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Fetch a list of your playlists.

This endpoint returns same data as listennotes.com/listen under your account. You can use the page parameter to do pagination and fetch more playlists.

query Parameters
sort
string
Default: "recent_added_first"
Enum: "recent_added_first" "oldest_added_first" "name_a_to_z" "name_z_to_a"
Example: sort=recent_added_first

How do you want to sort playlists?

page
integer
Default: 1
Example: page=1

Page number of playlists.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

Podcaster API

Endpoints to improve the podcast database

Request to delete a podcast

Podcast hosting services can use this endpoint to streamline the process of podcast deletion on behave of their users (podcasters). We will review the deletion request within 12 hours. If the podcast is already deleted, the "status" field in the response will be "deleted". Otherwise, the status field will be "in review". If you want to get a notification once the podcast is deleted, you can configure a webhook url in the dashboard: listennotes.com/api/dashboard/#webhooks

path Parameters
id
required
string
Example: 4d3fe717742d4963a85562e9f84d8c79

Podcast id. You can get podcast id from using other endpoints, e.g., GET /search, GET /best_podcasts...

query Parameters
reason
string
Example: reason=the podcaster wants to delete it

The reason why this podcast should be deleted, e.g., copyright violation, the podcaster wants to delete it... You can put "testing" here to indicate that you are testing this endpoint, so we will not actually delete the podcast.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "status": "deleted"
}

Submit a podcast to Listen Notes database

Podcast hosting services can use this endpoint to help your users directly submit a new podcast to Listen Notes database. If the podcast doesn't exist in the database, "status" in the response will be "in review", and we'll review it within 12 hours. If the podcast exists, "status" in the response will be "found". If this submission is rejected, "status" in the response will be "rejected". You can use POST /podcasts to check if multiple podcasts exist in the database. If you want to get a notification once the podcast is accepted, you can either specify the "email" parameter or configure a webhook url in the dashboard: listennotes.com/api/dashboard/#webhooks

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Request Body schema: application/x-www-form-urlencoded
required
rss
required
string

A valid podcast rss url.

email
string

A valid email address. If email is specified, then we'll notify this email address once the podcast is accepted.

Responses

Response samples

Content type
application/json
{}

Refresh RSS feed of a podcast

Refresh a podcast's RSS feed. Each podcast is limited to one refresh per hour. Refresh durations range from a few seconds to several minutes, contingent on the RSS feed size and server responsiveness. This endpoint is available only in the PRO/ENTERPRISE plan.

path Parameters
id
required
string
Example: 4d3fe717742d4963a85562e9f84d8c79

Podcast id. You can get podcast id from using other endpoints, e.g., GET /search, GET /best_podcasts...

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "status": "refreshing",
  • "last_refreshed_at_ms": 0
}

Insights API

Endpoints to get insights of podcasts, e.g., audience demographics

Fetch audience demographics for a podcast

Fetch audience demographics for a podcast - 1) directly measured on the Listen Notes platform; 2) only supports audience breakdown by regions for now; 3) not every podcast has data.

path Parameters
id
required
string
Example: 25212ac3c53240a880dd5032e547047b

Podcast id.

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{
  • "by_regions": [
    ]
}

Fetch podcasts by a publisher's domain name

Fetch podcasts by a publisher's domain name, e.g., nytimes.com, wondery.com, npr.org... Each request will return up to 10 podcasts. You can use the page parameter to paginate.

path Parameters
domain_name
required
string
Example: nytimes.com

A publisher's domain name, e.g., nytimes.com, wondery.com, npr.org...

query Parameters
page
integer
Default: 1
Example: page=1

Page number of the podcasts from this domain name

header Parameters
X-ListenAPI-Key
required
string

Get API Key on listennotes.com/api

Responses

Response samples

Content type
application/json
{}

podcastsSubmitAccepted Webhook

Request Body schema: application/json

Triggered by your request to POST /podcasts/submit, if the podcast submission is accepted.

image
string (ImageField)

Image url for this podcast's artwork. If you are using PRO/ENTERPRISE plan, then it's a high resolution image (1400x1400). If you are using FREE plan, then it's the same as thumbnail, low resolution image (300x300).

thumbnail
string (ThumbnailField)

Thumbnail image url for this podcast's artwork (300x300).

title
string (PodcastNameField)

Podcast name.

listennotes_url
string (PodcastLNUrlField)

The url of this podcast on ListenNotes.com.

id
string (PodcastIdField)

Podcast id, which can be used to further fetch detailed podcast metadata via GET /podcasts/{id}.

publisher
string (PublisherField)

Podcast publisher name.

rss
string (RssField)

RSS url of this podcast. This field is available only in the PRO/ENTERPRISE plan.

Responses

Request samples

Content type
application/json
{}

podcastsSubmitRejected Webhook

Request Body schema: application/json

Triggered by your request to POST /podcasts/submit, if the podcast submission is rejected.

object

Responses

Request samples

Content type
application/json
{}

podcastDeleted Webhook

Request Body schema: application/json

Triggered by your request to DELETE /podcasts/{id}, if the podcast is actually deleted.

image
string (ImageField)

Image url for this podcast's artwork. If you are using PRO/ENTERPRISE plan, then it's a high resolution image (1400x1400). If you are using FREE plan, then it's the same as thumbnail, low resolution image (300x300).

thumbnail
string (ThumbnailField)

Thumbnail image url for this podcast's artwork (300x300).

title
string (PodcastNameField)

Podcast name.

listennotes_url
string (PodcastLNUrlField)

The url of this podcast on ListenNotes.com.

id
string (PodcastIdField)

Podcast id, which can be used to further fetch detailed podcast metadata via GET /podcasts/{id}.

publisher
string (PublisherField)

Podcast publisher name.

rss
string (RssField)

RSS url of this podcast. This field is available only in the PRO/ENTERPRISE plan.

Responses

Request samples

Content type
application/json
{}