Submit a podcast to Listen Notes database
POST {{baseUrl}}/podcasts/submit
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
Request Body
[{"name"=>"rss", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"email", "value"=>"<string>", "datatype"=>"string"}]
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"podcast":{"image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","title":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","publisher":"\u003cstring\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e"},"status":"rejected"}