bbfc’s database already · 2015-09-04 · bbfc (uk): the british board of film classification is...

BBFC (UK): The British Board of Film Classification is an independent, non-governmental body which has classified cinema films since it was set up in 1912 and videos/ DVDs since the Video Recordings Act was passed in 1984. The BBFC database currently carries data for approximately 320,000 classification decisions upon which an abstraction layer, specifically designed to aid interoperability with third parties sits on top. BBFC’s database already is accessible for customers via a RESTful web API in combination with an API licence key. The BBFC scheme has been readily mappable to the MIRACLE specification, the existing API/data service has been extended to provide the data accessible in a MIRACLE-based format, both in XML and in JSON.

Web frontend & documentation http://developer.bbfc.co.uk/

Login and Password are “miracle”

API Base URL http://api.bbfc.co.uk/miracle/v1

API key DD6CEC795E3ACB8380257DD2004E0829

Sample query

http://api.bbfc.co.uk:80/miracle/v1/games/match?title=Assassins%20creed&format=XML&apiKey=DD6CEC795E3ACB8380257DD2004E0829

Sample response/dataset

<age-declaration xmlns="http://www.miracle-label.eu/ns/"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://www.miracle-label.eu/ns/

http://www.miracle-label.eu/ns/miracle-1-0.xsd">

<issuer>

<age-issuer>BBFC</age-issuer>

<issuer-url>http://www.bbfc.co.uk</issuer-url>

<issuer-

licence>http://www.bbfc.co.uk/sites/default/files/attachments/BBFC%2

0Digital%20Licence_0.pdf</issuer-licence>

<last-change>2013-05-07</last-change>

<country>

<country-code>GB</country-code>

</country>

</issuer>

<scope>

<scope-ids>

<scope-id class="BBFC-codenumber">AZG242241</scope-id>

</scope-ids>

<scope-titles>

<scope-title class="BBFC-title">ASSASSINS CREED</scope-title>

</scope-titles>

</scope>

<rating>

<age>15</age>

<age-adds>

<age-add class="BBFC-catgeory">15</age-add>

</age-adds>

<age-icons>

<age-icon class="BBFC-

symbol">http://api.bbfc.co.uk/symbols/15.png</age-icon>

</age-icons>

</rating>

<content-descriptors>

<cd-opentext>

<cd-opentext-desc class="BBFCinsightShort">Contains strong

bloody violence</cd-opentext-desc>

</cd-opentext>

</content-descriptors>

</age-declaration>