{
  "opencollection": "1.0.0",
  "info": {
    "name": "Listen API: Podcast Search, Directory, and Insights Directory API API",
    "version": "2.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "X-ListenAPI-Key",
      "value": "{{X-ListenAPI-Key}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Directory API",
        "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": "",
                "type": "query",
                "description": "Genre id (omit or 0 for overall best)."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Page number for pagination."
              },
              {
                "name": "region",
                "value": "",
                "type": "query",
                "description": "Region/country of the chart."
              },
              {
                "name": "publisher_region",
                "value": "",
                "type": "query",
                "description": "Filter by the publisher's region."
              },
              {
                "name": "language",
                "value": "",
                "type": "query",
                "description": "Filter by podcast language."
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "listen_score or recent_added_first."
              },
              {
                "name": "safe_mode",
                "value": "",
                "type": "query",
                "description": "1 = exclude explicit content."
              }
            ]
          },
          "docs": "Fetch a curated list of the best podcasts, optionally filtered by genre, region, and language."
        },
        {
          "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."
              },
              {
                "name": "next_episode_pub_date",
                "value": "",
                "type": "query",
                "description": "Timestamp (ms) to paginate episodes."
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "recent_first or oldest_first."
              }
            ]
          },
          "docs": "Fetch detailed metadata and a paginated list of episodes for a podcast by id."
        },
        {
          "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."
              },
              {
                "name": "show_transcript",
                "value": "",
                "type": "query",
                "description": "1 = include transcript when available."
              }
            ]
          },
          "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": "form-urlencoded",
              "data": [
                {
                  "name": "ids",
                  "value": ""
                }
              ]
            }
          },
          "docs": "Batch fetch basic metadata for up to 10 episodes by id."
        },
        {
          "info": {
            "name": "Batch fetch podcasts",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://listen-api.listennotes.com/api/v2/podcasts",
            "body": {
              "type": "form-urlencoded",
              "data": [
                {
                  "name": "ids",
                  "value": ""
                },
                {
                  "name": "rsses",
                  "value": ""
                },
                {
                  "name": "itunes_ids",
                  "value": ""
                },
                {
                  "name": "show_latest_episodes",
                  "value": ""
                }
              ]
            }
          },
          "docs": "Batch fetch basic metadata for up to 10 podcasts by id."
        },
        {
          "info": {
            "name": "Fetch curated lists of podcasts",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://listen-api.listennotes.com/api/v2/curated_podcasts",
            "params": [
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Page number for pagination."
              }
            ]
          },
          "docs": "Fetch a paginated list of curated podcast lists."
        },
        {
          "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, including the podcasts inside it."
        },
        {
          "info": {
            "name": "Fetch podcast genres",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://listen-api.listennotes.com/api/v2/genres",
            "params": [
              {
                "name": "top_level_only",
                "value": "",
                "type": "query",
                "description": "1 = only top-level genres."
              }
            ]
          },
          "docs": "Fetch the full list of podcast genres in the Listen Notes taxonomy."
        },
        {
          "info": {
            "name": "Fetch supported regions",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://listen-api.listennotes.com/api/v2/regions"
          },
          "docs": "Fetch the list of supported countries/regions for best-podcasts charts."
        },
        {
          "info": {
            "name": "Fetch supported languages",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://listen-api.listennotes.com/api/v2/languages"
          },
          "docs": "Fetch the list of supported languages for podcasts."
        },
        {
          "info": {
            "name": "Fetch a random episode",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://listen-api.listennotes.com/api/v2/just_listen",
            "params": [
              {
                "name": "safe_mode",
                "value": "",
                "type": "query",
                "description": "1 = exclude explicit content."
              }
            ]
          },
          "docs": "Fetch a random podcast episode (Just Listen) for serendipitous discovery."
        },
        {
          "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."
              },
              {
                "name": "safe_mode",
                "value": "",
                "type": "query",
                "description": "1 = exclude explicit content."
              }
            ]
          },
          "docs": "Fetch up to eight podcast recommendations for a given 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."
              },
              {
                "name": "safe_mode",
                "value": "",
                "type": "query",
                "description": "1 = exclude explicit content."
              }
            ]
          },
          "docs": "Fetch up to eight episode recommendations for a given episode."
        }
      ]
    }
  ],
  "bundled": true
}