Submit a podcast to Listen Notes database

v1.0.0

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

Input

{
  "type": "object",
  "properties": {
    "X-ListenAPI-Key": {
      "type": "string"
    }
  },
  "required": [
    "X-ListenAPI-Key"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "required": [
    "podcast",
    "status"
  ],
  "properties": {
    "podcast": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Podcast id, which can be used to further fetch detailed podcast metadata via `GET /podcasts/{id}`."
        },
        "image": {
          "type": "string",
          "description": "Image url for this podcast's artwork. If you are using PRO/ENTERPRISE plan, then it's\na high resolution image (1400x1400). If you are using FREE plan, then it's the same as **thumbnail**,\nlow resolution image (300x300).\n"
        },
        "listen_score": {
          "type": "integer",
          "description": "The estimated popularity score of a podcast compared to all other rss-based public podcasts in the world on a scale from 0 to 100.\nIf the score is not available, it'll be null. Learn more at listennotes.com/listen-score\n"
        },
        "listen_score_global_rank": {
          "type": "string",
          "description": "The estimated popularity ranking of a podcast compared to all other rss-based public podcasts in the world.\nFor example, if the value is 0.5%, then this podcast is one of the top 0.5% most popular shows out of all podcasts globally, ranked by Listen Score.\nIf the ranking is not available, it'll be null. Learn more at listennotes.com/listen-score\n"
        },
        "listennotes_url": {
          "type": "string",
          "description": "The url of this podcast on [ListenNotes.com](https://www.ListenNotes.com)."
        },
        "publisher": {
          "type": "string",
          "description": "Podcast publisher name."
        },
        "thumbnail": {
          "type": "string",
          "description": "Thumbnail image url for this podcast's artwork (300x300)."
        },
        "title": {
          "type": "string",
          "description": "Podcast name."
        }
      }
    },
    "status": {
      "type": "string",
      "description": "The status of this submission.",
      "enum": [
        "found",
        "in review",
        "rejected"
      ]
    }
  }
}