Podcast statistics API

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

Concepts

Please refer to the API Concepts page for more information.

API methods

The API methods below are RESTful implementations.

Summary

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
Parameters:

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]
<?xml version=”1.0″ encoding=”UTF-8″?>
<summary type=”array”>
<stats_url>http://stats.blubrry.com/ </stats_url>
<program_id>123</program_id>
<overall type=”array”>
<total>123</total>
<unique>123</unique>
<unique_repeat>123</unique_repeat>
</overall>
<current_month type=”array”>
<total>123</total>
<unique>123</unique>
<unique_repeat>123</unique_repeat>
</current_month>
<last_month type=”array”>
<total>123</total>
<unique>123</unique>
<unique_repeat>123</unique_repeat>
</last_month>
<media type=”array”>
<episode>
<id>123</id>
<title>Episode Title</title>
<filename>filename.ext</filename>
<date>Mon, 06 Apr 2009 05:26:15 +0000</date>
<overall>1234</overall>
<current_month>123</current_month>
</episode>
<episode>
<id>456</id>
<title>file2.ext</title>
<filename>file2.ext</filename>
<date>Mon, 01 Apr 2009 03:20:15 +0000</date>
<overall>2345</overall>
<current_month>234</current_month>
</episode>
</media>
</summary>
[/xml]

Totals

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

URL: http://api.blubrry.com/2/stats/program_keyword/totals.json
Formats: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.