{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/jellypod-com/json-schema/jellypod-com-insights-schema.json",
  "title": "Insights",
  "description": "Organization-wide performance for one period, with the same totals as the Studio Insights page.",
  "x-generated": "2026-11-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/jellypod-com-api-openapi.json#/components/schemas/Insights",
  "type": "object",
  "properties": {
    "as_of": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO-8601 time the saved analytics behind these numbers were captured. Null when nothing has been captured yet.",
      "readOnly": true
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "engagement": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "comments": {
                "type": "object",
                "properties": {
                  "current": {
                    "type": "number"
                  },
                  "previous": {
                    "type": "number"
                  }
                },
                "required": [
                  "current",
                  "previous"
                ]
              },
              "reactions": {
                "type": "object",
                "properties": {
                  "current": {
                    "type": "number"
                  },
                  "previous": {
                    "type": "number"
                  }
                },
                "required": [
                  "current",
                  "previous"
                ]
              }
            },
            "required": [
              "comments",
              "reactions"
            ]
          },
          "followers": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "current": {
                "type": "number"
              },
              "previous": {
                "type": "number"
              }
            },
            "required": [
              "current",
              "previous"
            ]
          },
          "name": {
            "type": "string"
          },
          "network": {
            "type": [
              "string",
              "null"
            ]
          },
          "plays": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "current": {
                "type": "number"
              },
              "previous": {
                "type": "number"
              }
            },
            "required": [
              "current",
              "previous"
            ]
          },
          "posts": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "current": {
                "type": "number"
              },
              "previous": {
                "type": "number"
              }
            },
            "required": [
              "current",
              "previous"
            ]
          },
          "source": {
            "type": "string",
            "enum": [
              "feed",
              "player",
              "channel"
            ]
          }
        },
        "required": [
          "engagement",
          "followers",
          "name",
          "network",
          "plays",
          "posts",
          "source"
        ]
      },
      "description": "Items posted, plays, engagement, and net followers gained per source: `feed` (podcast feeds), `player` (the Jellypod player), and each connected `channel`. A null value means the source does not report it."
    },
    "complete": {
      "type": "boolean",
      "description": "Whether every measured podcast has a saved analytics capture. When false the numbers are a floor rather than a total; retry later for a complete read.",
      "readOnly": true
    },
    "period": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "month",
        "last-month",
        "custom",
        "last-week"
      ]
    },
    "previous": {
      "type": "object",
      "properties": {
        "end": {
          "type": "string",
          "format": "date"
        },
        "start": {
          "type": "string",
          "format": "date"
        }
      },
      "required": [
        "end",
        "start"
      ],
      "description": "The equal-length period just before `range`, which every `previous` value covers."
    },
    "range": {
      "type": "object",
      "properties": {
        "end": {
          "type": "string",
          "format": "date"
        },
        "start": {
          "type": "string",
          "format": "date"
        }
      },
      "required": [
        "end",
        "start"
      ],
      "description": "Inclusive UTC days the `current` values cover."
    },
    "studio_url": {
      "type": "string",
      "format": "uri",
      "description": "The Studio Insights page for the same period and filter."
    },
    "summary": {
      "type": "object",
      "properties": {
        "channels_posted": {
          "type": "object",
          "properties": {
            "current": {
              "type": "number"
            },
            "previous": {
              "type": "number"
            }
          },
          "required": [
            "current",
            "previous"
          ]
        },
        "engagement": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "comments": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "previous": {
                  "type": "number"
                }
              },
              "required": [
                "current",
                "previous"
              ]
            },
            "reactions": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "previous": {
                  "type": "number"
                }
              },
              "required": [
                "current",
                "previous"
              ]
            },
            "rate": {
              "type": "object",
              "properties": {
                "current": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "previous": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "current",
                "previous"
              ]
            }
          },
          "required": [
            "comments",
            "reactions",
            "rate"
          ]
        },
        "plays": {
          "type": "object",
          "properties": {
            "current": {
              "type": "number"
            },
            "previous": {
              "type": "number"
            }
          },
          "required": [
            "current",
            "previous"
          ]
        },
        "published": {
          "type": "object",
          "properties": {
            "current": {
              "type": "number"
            },
            "previous": {
              "type": "number"
            }
          },
          "required": [
            "current",
            "previous"
          ]
        },
        "watch_time_sec": {
          "type": "object",
          "properties": {
            "current": {
              "type": "number"
            },
            "previous": {
              "type": "number"
            }
          },
          "required": [
            "current",
            "previous"
          ]
        }
      },
      "required": [
        "channels_posted",
        "engagement",
        "plays",
        "published",
        "watch_time_sec"
      ],
      "description": "Total plays, watch time in seconds (Jellypod player and YouTube), items published, Channels posted to, and reactions and comments with their rate per play, each as `current` and `previous`. `engagement` is null when no source captured it."
    },
    "takeaways": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string",
                "format": "uri"
              }
            },
            "required": [
              "label",
              "url"
            ]
          },
          "body": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "action",
          "body",
          "id",
          "title"
        ]
      },
      "description": "Up to three suggested next steps for the whole library, each with a Studio action."
    },
    "top_content": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "comments": {
            "type": [
              "number",
              "null"
            ]
          },
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "episode",
              "video",
              "short",
              "voiceover"
            ]
          },
          "plays": {
            "type": "number"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "reactions": {
            "type": [
              "number",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "watch_time_sec": {
            "type": "number"
          }
        },
        "required": [
          "comments",
          "id",
          "kind",
          "plays",
          "published_at",
          "reactions",
          "title",
          "watch_time_sec"
        ]
      },
      "description": "The five items with the most plays in `range`."
    }
  },
  "required": [
    "as_of",
    "channels",
    "complete",
    "period",
    "previous",
    "range",
    "studio_url",
    "summary",
    "takeaways",
    "top_content"
  ]
}