Podcast statistics API

API for third-party applications to access media download statistics from Blubrry.com.


Please refer to the API Concepts page for more information.

API methods

The API methods below are RESTful implementations.


Returns a summary report for a specific podcast program.

URL: http://api.blubrry.com/stats/program_keyword/summary.format
Formats: xml, json
Method(s): GET

month – specific month to pull summary from (optional; default: current month)
year – specific year to pull summary from (optional; default: current year)

Example output:

<?xml version=”1.0″ encoding=”UTF-8″?>
<summary type=”array”>
<stats_url>http://stats.blubrry.com/ </stats_url>
<overall type=”array”>
<current_month type=”array”>
<last_month type=”array”>
<media type=”array”>
<title>Episode Title</title>
<date>Mon, 06 Apr 2009 05:26:15 +0000</date>
<date>Mon, 01 Apr 2009 03:20:15 +0000</date>


Returns a record set of totals for a specific podcast program.

URL: http://api.blubrry.com/2/stats/program_keyword/totals.json
Method(s): GET

Note: Requires oAuth2 authentication, only available to professional statistics accounts.

Request URL Parameters

program_keyword – Required. Specifies the program to query download totals for.

GET Query String Parameters

start-date – Required. Start date for fetching Statistics data. Requests can specify a start date formatted as YYYY-MM-DD. Values must match [0-9]{4}-[0-9]{2}-[0-9]{2}.

end-date – End date for fetching Statistics data. Request can specify an end date formatted as YYYY-MM-DD. Values must match [0-9]{4}-[0-9]{2}-[0-9]{2}. Uses start-date if not specified.

Note: start-date and end-date range cannot exceed 45 days.

fields – Defaults to date,episode,downloads Selector specifying a subset of fields to include in the response. Fields include date (YYYY-MM-DD), episode (media file name), downloads.

start – Defaults to 0; the first position of data to retrieve, starting at 0. Use this parameter as a pagination mechanism along with the limit parameter.

limit – Defaults to 1000; the maximum number of rows to include in the response. Maximum value is 1000.

Additional parameters such as specifying a JSON-P callback function, advanced date parameters, and custom sorting options are available for qualified application developers. Please contact Blubrry with details about your application usage to see if you qualify.