Various updates from 2024 08 23

.editorconfig

@@ -8,6 +8,7 @@ indent_style = space
 insert_final_newline = true
 max_line_length = 120
 tab_width = 4
+trim_trailing_whitespace = true
 
 [{*.yaml,*.yml}]
 indent_size = 2

api_src/components/parameters/newest.yaml

@@ -0,0 +1,11 @@
+name: newest
+in: query
+# language=Markdown
+description: |
+  If present, returns only the most recent (newest) episode for each specified feed id.
+
+
+  Parameter shall not have a value
+schema:
+  type: boolean
+allowEmptyValue: true

api_src/components/properties/createdOn.yaml

@@ -0,0 +1,6 @@
+  # language=Markdown
+description: |
+  The first time the feed was seen by Podcast Index
+type: integer
+format: Unix Epoch
+example: 1613394034

api_src/components/properties/data_static.yaml

@@ -0,0 +1,18 @@
+  # language=Markdown
+description: |
+  Object containing the recent data
+type: object
+properties:
+  nextSince:
+      # language=Markdown
+    description: |
+      Value of `since` in next block of data
+    type: integer
+    format: Unix Epoch
+    example: 1613805249
+  position:
+    $ref: '../properties/position.yaml'
+  feeds:
+    $ref: '../properties/feeds_data.yaml'
+  items:
+    $ref: '../properties/items_data.yaml'

api_src/components/properties/episodeCountTotal.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Total individual podcast episodes in the index.
+type: integer
+example: 143953477

api_src/components/properties/episodesWithChapters.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Number of episodes with [`podcast:chapters`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#chapters)
+type: integer
+example: 652781

api_src/components/properties/episodesWithTranscripts.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Episodes with a
+  [`podcast:transcript`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#transcript)
+  tag.
+type: integer
+example: 3198597

api_src/components/properties/feedCountTotal.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Total podcast feeds in the index.
+type: integer
+example: 4257865

api_src/components/properties/feed_podcast_batch.yaml

@@ -0,0 +1,75 @@
+  # language=Markdown
+description: |
+  Known details of podcast feed
+type: object
+properties:
+  id:
+    $ref: '../properties/id_feed.yaml'
+  title:
+    $ref: '../properties/title_feed.yaml'
+  url:
+    $ref: '../properties/url_feed.yaml'
+  originalUrl:
+    $ref: '../properties/originalUrl.yaml'
+  link:
+    $ref: '../properties/link_feed.yaml'
+  description:
+    $ref: '../properties/description_feed.yaml'
+  author:
+    $ref: '../properties/author.yaml'
+  ownerName:
+    $ref: '../properties/ownerName.yaml'
+  image:
+    $ref: '../properties/image_feed.yaml'
+  artwork:
+    $ref: '../properties/artwork.yaml'
+  lastUpdateTime:
+    $ref: '../properties/lastUpdateTime.yaml'
+  lastCrawlTime:
+    $ref: '../properties/lastCrawlTime.yaml'
+  lastParseTime:
+    $ref: '../properties/lastParseTime.yaml'
+  inPollingQueue:
+    $ref: '../properties/inPollingQueue.yaml'
+  priority:
+    $ref: '../properties/priority.yaml'
+  lastGoodHttpStatusTime:
+    $ref: '../properties/lastGoodHttpStatusTime.yaml'
+  lastHttpStatus:
+    $ref: '../properties/lastHttpStatus.yaml'
+  contentType:
+    $ref: '../properties/contentType.yaml'
+  itunesId:
+    $ref: '../properties/itunesId_feed.yaml'
+  generator:
+    $ref: '../properties/generator.yaml'
+  createdOn:
+    $ref: '../properties/createdOn.yaml'
+  language:
+    $ref: '../properties/language.yaml'
+  type:
+    $ref: '../properties/type.yaml'
+  dead:
+    $ref: '../properties/dead.yaml'
+  crawlErrors:
+    $ref: '../properties/crawlErrors.yaml'
+  parseErrors:
+    $ref: '../properties/parseErrors.yaml'
+  categories:
+    $ref: '../properties/categories.yaml'
+  locked:
+    $ref: '../properties/locked.yaml'
+  explicit:
+    $ref: '../properties/explicit_feed.yaml'
+  podcastGuid:
+    $ref: '../properties/podcastguid.yaml'
+  medium:
+    $ref: '../properties/medium_feed.yaml'
+  episodeCount:
+    $ref: '../properties/episodeCount.yaml'
+  imageUrlHash:
+    $ref: '../properties/imageUrlHash.yaml'
+  newestItemPubdate:
+    $ref: '../properties/newestItemPublishTime.yaml'
+  valueBlock:
+    $ref: '../properties/valueBlock.yaml'

api_src/components/properties/feedsWithChapters.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a
+  [`podcast:chapters`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#chapters)
+  tag in at least 1 episode.
+type: integer
+example: 35582

api_src/components/properties/feedsWithFundingTag.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a
+  [`podcast:funding`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#funding)
+  tag in at least 1 episode.
+type: integer
+example: 57582

api_src/components/properties/feedsWithMediumMusic.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a
+  [`podcast:medium`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#medium)
+  tag with a value of `music`.
+type: integer
+example: 3700

api_src/components/properties/feedsWithMediumVideo.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a
+  [`podcast:medium`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#medium)
+  tag with a value of `video`.
+type: integer
+example: 1288

api_src/components/properties/feedsWithNewEpisodes10days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode released in the last 10 days.
+type: integer
+example: 212322

api_src/components/properties/feedsWithNewEpisodes14days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode released in the last 14 days.
+type: integer
+example: 239664

api_src/components/properties/feedsWithNewEpisodes30days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode released in the last 30 days.
+type: integer
+example: 306748

api_src/components/properties/feedsWithNewEpisodes3days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode released in the last 3 days.
+type: integer
+example: 97522

api_src/components/properties/feedsWithNewEpisodes60days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode released in the last 60 days.
+type: integer
+example: 382945

api_src/components/properties/feedsWithNewEpisodes7days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode released in the last 7 days.
+type: integer
+example: 179043

api_src/components/properties/feedsWithNewEpisodes90days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode released in the last 90 days.
+type: integer
+example: 436933

api_src/components/properties/feedsWithTranscripts.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a
+  [`podcast:transcript`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#transcript)
+  tag in at least 1 episode.
+type: integer
+example: 61385

api_src/components/properties/feedsWithValueBlocks.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  tag in at least 1 episode.
+type: integer
+example: 21916

api_src/components/properties/feeds_batch.yaml

@@ -0,0 +1,6 @@
+  # language=Markdown
+description: |
+  List of feeds with matching GUID
+type: array
+items:
+  $ref: 'feed_podcast_batch.yaml'

api_src/components/properties/inPollingQueue.yaml

@@ -0,0 +1,6 @@
+  # language=Markdown
+description: |
+  Indicates if feed is currently scheduled to be polled/checked for new episodes.
+type: integer
+nullable: true
+example: 1

api_src/components/properties/newEpisodes10days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a released in the last 10 days.
+type: integer
+example: 684833

api_src/components/properties/newEpisodes14days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a released in the last 14 days.
+type: integer
+example: 907203

api_src/components/properties/newEpisodes30days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a released in the last 30 days.
+type: integer
+example: 1901547

api_src/components/properties/newEpisodes3days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a released in the last 3 days.
+type: integer
+example: 212324

api_src/components/properties/newEpisodes60days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a released in the last 60 days.
+type: integer
+example: 3710750

api_src/components/properties/newEpisodes7days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a released in the last 7 days.
+type: integer
+example: 442061

api_src/components/properties/newEpisodes90days.yaml

@@ -0,0 +1,5 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a released in the last 90 days.
+type: integer
+example: 5498580

api_src/components/properties/paidFeedsWithNewEpisodes10days.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  block released in the last 10 days.
+type: integer
+example: 165789

api_src/components/properties/paidFeedsWithNewEpisodes14days.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  block released in the last 14 days.
+type: integer
+example: 186602

api_src/components/properties/paidFeedsWithNewEpisodes30days.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  block released in the last 30 days.
+type: integer
+example: 237389

api_src/components/properties/paidFeedsWithNewEpisodes3days.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  block released in the last 3 days.
+type: integer
+example: 77638

api_src/components/properties/paidFeedsWithNewEpisodes60days.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  block released in the last 60 days.
+type: integer
+example: 77632

api_src/components/properties/paidFeedsWithNewEpisodes7days.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  block released in the last 7 days.
+type: integer
+example: 140275

api_src/components/properties/paidFeedsWithNewEpisodes90days.yaml

@@ -0,0 +1,7 @@
+  # language=Markdown
+description: |
+  Podcast feeds with a new episode containing a
+  [`podcast:value`](https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md#value)
+  block released in the last 90 days.
+type: integer
+example: 335380

api_src/components/properties/priority.yaml

@@ -0,0 +1,15 @@
+  # language=Markdown
+description: |
+  How often the feed is checked for updates and new episodes
+
+  A value of -1 means never check. A value of 5 means check the most.
+type: integer
+enum:
+  - -1
+  - 0
+  - 1
+  - 2
+  - 3
+  - 4
+  - 5
+example: 5