Get Insights across all content
/v1/insightsAuthorizationBearer token · headerrequiredAPI key issued from /settings/api-keys in the Jellypod studio. Send as Authorization: Bearer <key>.
periodstringReporting period in UTC days: 7d, 30d (default), month (month to date), last-month, last-week (the last complete Monday to Sunday week), or custom with from and to. Every number is compared with the period of equal length just before it.
7d30dmonthlast-monthcustomlast-weekfromstring<date>First day (YYYY-MM-DD, UTC) of a custom period.
tostring<date>Last day (YYYY-MM-DD, UTC) of a custom period, at most 180 days after from. A day after today reads as today.
kindstringCount only Episodes, Videos, or Shorts.
episodevideoshortOrganization-wide Insights for the period
dataInsightsrequiredOrganization-wide performance for one period, with the same totals as the Studio Insights page.
Show propertiesHide properties
as_ofstring | nullrequiredISO-8601 time the saved analytics behind these numbers were captured. Null when nothing has been captured yet.
channelsobject[]requiredItems 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.
Show propertiesHide properties
objectengagementobject | nullrequiredShow propertiesHide properties
commentsobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredreactionsobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredfollowersobject | nullrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequirednamestringrequirednetworkstring | nullrequiredplaysobject | nullrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredpostsobject | nullrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredsourcestringrequiredfeedplayerchannelcompletebooleanrequiredWhether 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.
periodstringrequired7d30dmonthlast-monthcustomlast-weekpreviousobjectrequiredThe equal-length period just before range, which every previous value covers.
Show propertiesHide properties
endstring<date>requiredstartstring<date>requiredrangeobjectrequiredInclusive UTC days the current values cover.
Show propertiesHide properties
endstring<date>requiredstartstring<date>requiredstudio_urlstring<uri>requiredThe Studio Insights page for the same period and filter.
summaryobjectrequiredTotal 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.
Show propertiesHide properties
channels_postedobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredengagementobject | nullrequiredShow propertiesHide properties
commentsobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredreactionsobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredrateobjectrequiredShow propertiesHide properties
currentnumber | nullrequiredpreviousnumber | nullrequiredplaysobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredpublishedobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredwatch_time_secobjectrequiredShow propertiesHide properties
currentnumberrequiredpreviousnumberrequiredtakeawaysobject[]requiredUp to three suggested next steps for the whole library, each with a Studio action.
Show propertiesHide properties
objectactionobjectrequiredShow propertiesHide properties
labelstringrequiredurlstring<uri>requiredbodystringrequiredidstringrequiredtitlestringrequiredtop_contentobject[]requiredThe five items with the most plays in range.
Show propertiesHide properties
objectcommentsnumber | nullrequiredidstringrequiredkindstringrequiredepisodevideoshortvoiceoverplaysnumberrequiredpublished_atstring | nullrequiredreactionsnumber | nullrequiredtitlestringrequiredwatch_time_secnumberrequiredValidation failed or malformed request.
detailstringLonger human-readable explanation when available.
errorsobject[]Per-field validation failures. Present when type is validation_error.
Show propertiesHide properties
objectfieldstringrequiredmessagestringrequiredreasonstringScript import failure when one or more Speakers have no saved Character match.
unresolved_speakersrecoveryobjectShow propertiesHide properties
actionstringrequiredcorrect_inputchoose_characterscheck_accountpoll_contentopen_studiocheck_contentreconnectretrycheck_resultidempotency_keystringreusenewpoll_after_secondsnumbertoolstringlist_characterslist_contentget_contentsave_podcastrequest_idstringCorrelation id, also returned in the X-Request-Id response header. Include in support requests.
speakersstring[]Speaker labels needing a saved Character match when reason is unresolved_speakers.
statusintegerrequiredHTTP status code mirrored from the response.
titlestringrequiredShort human-readable summary.
typestringrequiredMachine-readable error class. Suitable for switch/match in client code.
bad_requestvalidation_errorunauthorizedforbiddennot_foundconflictmethod_not_allowedunsupported_media_typeunprocessable_entityrate_limitedbad_gatewayinternal_errorMissing or invalid API key.
detailstringLonger human-readable explanation when available.
errorsobject[]Per-field validation failures. Present when type is validation_error.
Show propertiesHide properties
objectfieldstringrequiredmessagestringrequiredreasonstringScript import failure when one or more Speakers have no saved Character match.
unresolved_speakersrecoveryobjectShow propertiesHide properties
actionstringrequiredcorrect_inputchoose_characterscheck_accountpoll_contentopen_studiocheck_contentreconnectretrycheck_resultidempotency_keystringreusenewpoll_after_secondsnumbertoolstringlist_characterslist_contentget_contentsave_podcastrequest_idstringCorrelation id, also returned in the X-Request-Id response header. Include in support requests.
speakersstring[]Speaker labels needing a saved Character match when reason is unresolved_speakers.
statusintegerrequiredHTTP status code mirrored from the response.
titlestringrequiredShort human-readable summary.
typestringrequiredMachine-readable error class. Suitable for switch/match in client code.
bad_requestvalidation_errorunauthorizedforbiddennot_foundconflictmethod_not_allowedunsupported_media_typeunprocessable_entityrate_limitedbad_gatewayinternal_errorAuthenticated, but this API key does not have access to this resource.
detailstringLonger human-readable explanation when available.
errorsobject[]Per-field validation failures. Present when type is validation_error.
Show propertiesHide properties
objectfieldstringrequiredmessagestringrequiredreasonstringScript import failure when one or more Speakers have no saved Character match.
unresolved_speakersrecoveryobjectShow propertiesHide properties
actionstringrequiredcorrect_inputchoose_characterscheck_accountpoll_contentopen_studiocheck_contentreconnectretrycheck_resultidempotency_keystringreusenewpoll_after_secondsnumbertoolstringlist_characterslist_contentget_contentsave_podcastrequest_idstringCorrelation id, also returned in the X-Request-Id response header. Include in support requests.
speakersstring[]Speaker labels needing a saved Character match when reason is unresolved_speakers.
statusintegerrequiredHTTP status code mirrored from the response.
titlestringrequiredShort human-readable summary.
typestringrequiredMachine-readable error class. Suitable for switch/match in client code.
bad_requestvalidation_errorunauthorizedforbiddennot_foundconflictmethod_not_allowedunsupported_media_typeunprocessable_entityrate_limitedbad_gatewayinternal_errorResource not found.
detailstringLonger human-readable explanation when available.
errorsobject[]Per-field validation failures. Present when type is validation_error.
Show propertiesHide properties
objectfieldstringrequiredmessagestringrequiredreasonstringScript import failure when one or more Speakers have no saved Character match.
unresolved_speakersrecoveryobjectShow propertiesHide properties
actionstringrequiredcorrect_inputchoose_characterscheck_accountpoll_contentopen_studiocheck_contentreconnectretrycheck_resultidempotency_keystringreusenewpoll_after_secondsnumbertoolstringlist_characterslist_contentget_contentsave_podcastrequest_idstringCorrelation id, also returned in the X-Request-Id response header. Include in support requests.
speakersstring[]Speaker labels needing a saved Character match when reason is unresolved_speakers.
statusintegerrequiredHTTP status code mirrored from the response.
titlestringrequiredShort human-readable summary.
typestringrequiredMachine-readable error class. Suitable for switch/match in client code.
bad_requestvalidation_errorunauthorizedforbiddennot_foundconflictmethod_not_allowedunsupported_media_typeunprocessable_entityrate_limitedbad_gatewayinternal_errorRate limit exceeded. Wait Retry-After seconds before retrying; RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset describe the window.
detailstringLonger human-readable explanation when available.
errorsobject[]Per-field validation failures. Present when type is validation_error.
Show propertiesHide properties
objectfieldstringrequiredmessagestringrequiredreasonstringScript import failure when one or more Speakers have no saved Character match.
unresolved_speakersrecoveryobjectShow propertiesHide properties
actionstringrequiredcorrect_inputchoose_characterscheck_accountpoll_contentopen_studiocheck_contentreconnectretrycheck_resultidempotency_keystringreusenewpoll_after_secondsnumbertoolstringlist_characterslist_contentget_contentsave_podcastrequest_idstringCorrelation id, also returned in the X-Request-Id response header. Include in support requests.
speakersstring[]Speaker labels needing a saved Character match when reason is unresolved_speakers.
statusintegerrequiredHTTP status code mirrored from the response.
titlestringrequiredShort human-readable summary.
typestringrequiredMachine-readable error class. Suitable for switch/match in client code.
bad_requestvalidation_errorunauthorizedforbiddennot_foundconflictmethod_not_allowedunsupported_media_typeunprocessable_entityrate_limitedbad_gatewayinternal_errorInternal server error.
detailstringLonger human-readable explanation when available.
errorsobject[]Per-field validation failures. Present when type is validation_error.
Show propertiesHide properties
objectfieldstringrequiredmessagestringrequiredreasonstringScript import failure when one or more Speakers have no saved Character match.
unresolved_speakersrecoveryobjectShow propertiesHide properties
actionstringrequiredcorrect_inputchoose_characterscheck_accountpoll_contentopen_studiocheck_contentreconnectretrycheck_resultidempotency_keystringreusenewpoll_after_secondsnumbertoolstringlist_characterslist_contentget_contentsave_podcastrequest_idstringCorrelation id, also returned in the X-Request-Id response header. Include in support requests.
speakersstring[]Speaker labels needing a saved Character match when reason is unresolved_speakers.
statusintegerrequiredHTTP status code mirrored from the response.
titlestringrequiredShort human-readable summary.
typestringrequiredMachine-readable error class. Suitable for switch/match in client code.
bad_requestvalidation_errorunauthorizedforbiddennot_foundconflictmethod_not_allowedunsupported_media_typeunprocessable_entityrate_limitedbad_gatewayinternal_error