Instructions for Developers

Blubrry Podcast Statistics (both professional and free basic versions) use the same method to measure podcast downloads.

How it works

An HTTP URL is placed in front of the URL where the media file is hosted. This new URL is followed; the servers immediately redirect the request to the original media URL. The process records all of the necessary metadata to report the download in the statistics system.

Statistics gathering is a separate process from the processing and reporting to provide a nearly 100 percent up-time guarantee. The “logging” servers have only one task and redundancy is applied to assure 100 percent up-time. Because of this setup, there is a delay of 1 to 2 hours between a logged download and the statistical analysis.

How to add statistics support to your own application

Note: The following instructions apply not only to Blubrry Statistics, but also for other statistics services such as TechPodcasts.com and RawVoice.com that utilize the same statistics redirect system.

Each program is issued a unique Media Statistics Redirect URL. This URL will measure media downloads for any type of audio, video, portable documents hosted on a HTTP/1.1-complaint service. Common audio formats include mp3 and m4a. Common video formats include mp4, m4v. Common portable documents include pdf and epub. For a full list please see the audio, video and document formats supported section at the bottom of this document.

Example Statistics Redirect URL: http://media.blubrry.com/demo/

Example Media URL without the redirect: http://example.com/path/to/file.mp3

Take the Media URL and remove the http:// from the beginning of the URL address.

example.com/path/to/file.mp3

Then place the statistics redirect URL in front of the media URL:

http://media.blubrry.com/demo/example.com/path/to/file.mp3

The provided media redirect URL should be applied anywhere you link to your media URLS including in website players, website download links, as well as in your podcast RSS feeds.

Applications with configuration settings

For applications that provide configuration settings, a field labeled “Media Statistics Redirect URL” is ideal and allows your users to simply copy and paste their unique statistics media redirect URL into the field and click “save.”

Submit your application to Blubrry

If your application or service supports Blubrry Podcast Staitsitcs, let us know so we can publish a page on this site with instructions how to setup Blubrry Statistics with your application. Include the following information:

  • Basic instructions how to get to the setting and how to save
  • Screenshot(s) where applicable
  • Any licensing and/or feeds associated with using you application, if applicable
  • Any links back to your website

Send this information to cio [at] rawvoice dot com.

Audio, video and document formats supported

Essentially any audio and video file format is supported by the statistics system. If the standard HTTP content type for the document starts with “audio” or “video” (e.g. audio/mp3) then there will be no issues.