{
  "opencollection": "1.0.0",
  "info": {
    "name": "PodcastIndex.org Add Recent API",
    "version": "1.12.1"
  },
  "items": [
    {
      "info": {
        "name": "Recent",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Episodes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.podcastindex.org/api/1.0/recent/episodes",
            "params": [
              {
                "name": "max",
                "value": "7",
                "type": "query",
                "description": "Maximum number of results to return.\n"
              },
              {
                "name": "excludeString",
                "value": "religion",
                "type": "query",
                "description": "Any item containing this string will be discarded from the result set.\n\n\nThis may, in certain cases, reduce your set size below your `max` value.\n\n\nMatches against the `title` and URL properties.\n"
              },
              {
                "name": "before",
                "value": "1721351091",
                "type": "query",
                "description": "If you pass a PodcastIndex Episode ID, you will get recent episodes before that ID, allowing you to walk back\nthrough the episode history sequentially.\n"
              },
              {
                "name": "fulltext",
                "value": "",
                "type": "query",
                "description": "If present, return the full text value of any text fields (ex: `description`).\nIf not provided, field value is truncated to 100 words.\n\n\nParameter shall not have a value\n"
              },
              {
                "name": "pretty",
                "value": "",
                "type": "query",
                "description": "If present, makes the output “pretty” to help with debugging.\n\n\nParameter shall not have a value\n"
              }
            ],
            "auth": {
              "type": "apikey",
              "key": "X-Auth-Key",
              "value": "{{X-Auth-Key}}",
              "placement": "header"
            }
          },
          "docs": "This call returns the most recent `max` number of episodes globally across the whole index,\nin reverse chronological order.\n\n\nExample: https://api.podcastindex.org/api/1.0/recent/episodes?max=7&pretty\n"
        },
        {
          "info": {
            "name": "Feeds",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.podcastindex.org/api/1.0/recent/feeds",
            "params": [
              {
                "name": "max",
                "value": "20",
                "type": "query",
                "description": "Maximum number of results to return.\n"
              },
              {
                "name": "since",
                "value": "1612125785",
                "type": "query",
                "description": "Return items since the specified epoch timestamp.\n"
              },
              {
                "name": "lang",
                "value": "",
                "type": "query",
                "description": "Specifying a language code (like \"en\") will return only episodes having that specific language.\n\n\nYou can specify multiple languages by separating them with commas.\n\n\nIf you also want to return episodes that have no language given, use the token \"unknown\". (ex. en,es,ja,unknown).\n\n\nValues are not case sensitive.\n"
              },
              {
                "name": "cat",
                "value": "",
                "type": "query",
                "description": "Use this argument to specify that you **ONLY** want episodes with these categories in the results.\n\n\nSeparate multiple categories with commas.\n\n\nYou may specify either the Category ID and/or the Category Name.\n\n\nValues are not case sensitive.\n\n\nThe `cat` and `notcat` filters can be used together to fine tune a very specific result set.\n\n\nCategory numbers and names can be found in the\n[Podcast Namespace documentation](https://github.com/Podcastindex-org/podcast-namespace/blob/main/categories.json)\n"
              },
              {
                "name": "notcat",
                "value": "",
                "type": "query",
                "description": "Use this argument to specify categories of episodes to **NOT** show in the results.\n\n\nSeparate multiple categories with commas.\n\n\nYou may specify either the Category ID and/or the Category Name.\n\n\nValues are not case sensitive.\n\n\nThe `cat` and `notcat` filters can be used together to fine tune a very specific result set.\n\n\nCategory numbers and names can be found in the\n[Podcast Namespace documentation](https://github.com/Podcastindex-org/podcast-namespace/blob/main/categories.json)\n"
              },
              {
                "name": "pretty",
                "value": "",
                "type": "query",
                "description": "If present, makes the output “pretty” to help with debugging.\n\n\nParameter shall not have a value\n"
              }
            ],
            "auth": {
              "type": "apikey",
              "key": "X-Auth-Key",
              "value": "{{X-Auth-Key}}",
              "placement": "header"
            }
          },
          "docs": "This call returns the most recent `max` feeds, in reverse chronological order.\n\n\nExamples:\n\n  - https://api.podcastindex.org/api/1.0/recent/feeds?pretty\n  - https://api.podcastindex.org/api/1.0/recent/feeds?max=20&cat=102,health&lang=de,ja&pretty\n"
        },
        {
          "info": {
            "name": "New Feeds",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.podcastindex.org/api/1.0/recent/newfeeds",
            "params": [
              {
                "name": "max",
                "value": "20",
                "type": "query",
                "description": "Maximum number of results to return.\n"
              },
              {
                "name": "since",
                "value": "1612125785",
                "type": "query",
                "description": "Return items since the specified epoch timestamp.\n"
              },
              {
                "name": "feedid",
                "value": "2653471",
                "type": "query",
                "description": "The PodcastIndex Feed ID to start from (or go to if `desc` specified).\n\n\nIf `since` parameter also specified, value of `since` is ignored.\n"
              },
              {
                "name": "desc",
                "value": "",
                "type": "query",
                "description": "If present, display feeds in descending order.\n\n\nOnly applicable when using `feedid` parameter.\n\n\nParameter shall not have a value\n"
              },
              {
                "name": "pretty",
                "value": "",
                "type": "query",
                "description": "If present, makes the output “pretty” to help with debugging.\n\n\nParameter shall not have a value\n"
              }
            ],
            "auth": {
              "type": "apikey",
              "key": "X-Auth-Key",
              "value": "{{X-Auth-Key}}",
              "placement": "header"
            }
          },
          "docs": "This call returns every new feed added to the index over the past 24 hours in reverse chronological order.\n\n\nExamples:\n\n  - https://api.podcastindex.org/api/1.0/recent/newfeeds?pretty\n  - https://api.podcastindex.org/api/1.0/recent/newfeeds?pretty&since=1613805000\n  - https://api.podcastindex.org/api/1.0/recent/newfeeds?feedid=2653471&pretty\n  - https://api.podcastindex.org/api/1.0/recent/newfeeds?feedid=2653471&desc&pretty\n"
        },
        {
          "info": {
            "name": "New Value Feeds",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.podcastindex.org/api/1.0/recent/newvaluefeeds",
            "params": [
              {
                "name": "max",
                "value": "20",
                "type": "query",
                "description": "Maximum number of results to return.\n"
              },
              {
                "name": "since",
                "value": "1612125785",
                "type": "query",
                "description": "Return items since the specified epoch timestamp.\n"
              },
              {
                "name": "pretty",
                "value": "",
                "type": "query",
                "description": "If present, makes the output “pretty” to help with debugging.\n\n\nParameter shall not have a value\n"
              }
            ],
            "auth": {
              "type": "apikey",
              "key": "X-Auth-Key",
              "value": "{{X-Auth-Key}}",
              "placement": "header"
            }
          },
          "docs": "This call returns feeds that have added a `value` tag in reverse chronological order.\n\n\nExample: https://api.podcastindex.org/api/1.0/recent/newvaluefeeds?pretty\n"
        },
        {
          "info": {
            "name": "Recent Data",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.podcastindex.org/api/1.0/recent/data",
            "params": [
              {
                "name": "max",
                "value": "200",
                "type": "query",
                "description": "Maximum number of results to return (includes both `feeds` and `items`).\n"
              },
              {
                "name": "since",
                "value": "1612125785",
                "type": "query",
                "description": "Return items since the specified epoch timestamp.\n"
              },
              {
                "name": "pretty",
                "value": "",
                "type": "query",
                "description": "If present, makes the output “pretty” to help with debugging.\n\n\nParameter shall not have a value\n"
              }
            ],
            "auth": {
              "type": "apikey",
              "key": "X-Auth-Key",
              "value": "{{X-Auth-Key}}",
              "placement": "header"
            }
          },
          "docs": "This call returns every new feed and episode added to the index over the past 24 hours in reverse chronological order.\n\n\nThis is similar to `/recent/feeds` but uses the date the feed was found by the index rather than the feed's\ninternal timestamp.\n\n\nSimilar data can also be accessed using object storage root url https://tracking.podcastindex.org/current\nFor details, see [Current](#get-/static/tracking/current).\n\n\nExamples:\n\n  - https://api.podcastindex.org/api/1.0/recent/data?pretty\n  - https:/"
        },
        {
          "info": {
            "name": "Soundbites",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.podcastindex.org/api/1.0/recent/soundbites",
            "params": [
              {
                "name": "max",
                "value": "20",
                "type": "query",
                "description": "Maximum number of soundbites to return.\n"
              },
              {
                "name": "pretty",
                "value": "",
                "type": "query",
                "description": "If present, makes the output “pretty” to help with debugging.\n\n\nParameter shall not have a value\n"
              }
            ],
            "auth": {
              "type": "apikey",
              "key": "X-Auth-Key",
              "value": "{{X-Auth-Key}}",
              "placement": "header"
            }
          },
          "docs": "This call returns the most recent `max` soundbites that the index has discovered.\n\n\nA soundbite consists of an enclosure url, a start time and a duration.\nIt is documented in the [podcast namespace](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#soundbite).\n\n\nExample: https://api.podcastindex.org/api/1.0/recent/soundbites?pretty\n"
        }
      ]
    }
  ],
  "bundled": true
}