Media 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]

Note: The method above is still under review and may be subject to change.