search

buzzsprout / buzzsprout-api

The official documentation for the Buzzsprout API (http://www.buzzsprout.com).
48 stars 10 forks source link

Get download/listening stats for an episode #20

Closed eric-hansen closed 2 years ago

eric-hansen commented 4 years ago

Looking at episodes.md doesn't seem like we can pull stats about an episode.

For creating a simple viewing script in say Vim or VS Code it would be helpful to also pull the stats about an episode.

johnloringpollard commented 4 years ago

Currently, you can get the total downloads from the API by using the episodes INDEX or SHOW. We haven't exposed any of the other stats but we have talked about it.

eric-hansen commented 4 years ago

Understand, I saw the total plays on the episodes endpoint after making the issue. But just figured having a more drilled-down report would be good as well since it's already exposed in the dashboard. But I also get that the API isn't meant to be a dashboard replacement.

On Tue, Sep 15, 2020 at 10:09 AM John Pollard notifications@github.com wrote:

Currently, you can get the total downloads from the API by using the episodes INDEX or SHOW. We haven't exposed any of the other stats but we have talked about it.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/buzzsprout/buzzsprout-api/issues/20#issuecomment-692739890, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB7DKZYM2SG7MR3OCOMEQN3SF5YQ5ANCNFSM4RMEJ4AA .

-- Thank you,

Eric Hansen

johnloringpollard commented 4 years ago

Can you tell me what stats you are specifically interested in? Can't say when or if we will do it but hearing from customers and what they find useful helps a ton.

eric-hansen commented 4 years ago

Sure. So first, I tend to look for ways to make data more meaningful for me, which the Buzzsprout dashboard offers mostly. But, the ideas I have, for example, are being able to better see correlations.

Most of my episodes are around 5-10 mins in length, how does that relate to plays? Which devices and platforms had the most plays for X length, which topics/series offered the most plays (and drilling deeper from there).

Also I use NeoVim to program and like just scripting information to view it in the command line vs. having to go into my browser and stuff. I.e.: I wrote a JIRA/ticket viewer for NeoVim for that reason. So being able to have a deeper breakdown of plays would allow me to generate reports, information, etc... that is more meaningful but may not always be useful for your greater audience.

johnloringpollard commented 4 years ago

Thanks for the info! If we add more stats to the API we will take this info into consideration. I will leave this open for others to chime in too.

timkapil commented 3 years ago

Hi. I am trying to create a community connector for data studio. I have already imported the existing fields that the api is providing us. But I also need country and device data that you guys show on the stats page of buzzsprout website.

Right now there's no such data available in the REST Api. Could you please tell me if that's possible to get?

johnloringpollard commented 3 years ago

Right now that is not possible. This is something we have looked into but we haven't exposed that data with the API yet.

mc25573 commented 2 years ago

Currently, you can get the total downloads from the API by using the episodes INDEX or SHOW. We haven't exposed any of the other stats but we have talked about it.

what are INDEX and SHOW? properties of the returned response? IDs for the endpoint?

tomrossi7 commented 2 years ago

@mc25573 if you look at this page for "total_plays", that shows you the total downloads for the episode. We used to call them "plays". Sorry for the confusion!