Filmaster unveils movie recommendation API
It’s ready and it’s hot. First totally open and free (as in beer and as in freedom) film recommendations API is here for you as a gift from Filmaster. The API enables external programmers to create independent services or apps using our data and algorithms, it allows to easily integrate any website with Filmaster by presenting our content like reviews and film recommendations. Sounds interesting? Read on!
What’s in the API?
The first version of Filmaster API is already pretty complete, i.e. it allows you to do anything that you can do on the website. In particular:
There are also some beta features that we have not fully tested, but you are welcome to test them and use them if you are not afraid:
The API has been crafted using the REST standard, i.e. we’re using HTTP protocol, all resources are acessible via URI addresses and each operation (read, write/update, delete) are realized through corresponding HTTP calls (GET, POST/PUT, DELETE). The data is packed in JSON format. All URI addresses in the API start with the API version (currently it’s the 1.0 prefix).
I’m a programmer. What can I do with the API?
Quite a lot! Wiele! As we give you access to almost all the features currently available on Filmaster.com (with some that are still being beta-tested), Filmaster itself is the only limit.
Here are a few ideas though:
Mariusz Kryński, the author of the API (written in Python, just like Filmaster) wrote a sample app to show you how the API works in practice.
The app fetches all your Filmaster friends (people you follow). You can choose any of them and then it computes the films that you should watch together. Pretty brilliat for film parties! (obviously you all need to use Filmaster for the app to work).
There is the code of the app. Contrary to the Filmaster code base (which is licensed under Affery GPLv3), this is public domain so you can use it in your application with no restrictions: https://bitbucket.org/mrk/filmaster-api-sample
License and restrictions
All the user-contributed content (like reviews, opinions) is licensed under Creative Commons Attribution 3.0. This means you can use any of it on your website or app as long as you comply with the license terms.
Using Filmaster API is free and it should stay this way for people. Still, we’d like to keep the possibility to, at some point, start charging a minimal amount of money in case your monthly transfer usage is very high. More clarifications below:
- If you have a blog and you would like to place a widget with your latest film ratings from Filmaster, you can be sure you will be always able to do that. Even if your blog is Cinematical.com (or perhaps especially then).
In any case, if you decide to start using Filmaster API, please tell us about your project. We’d be very happy to promote it. Just send an e-mail to email@example.com explaining your idea.
Documentation and support
The API is documented on our wiki: http://filmaster.org/display/DEV/API. The contact person for API is Mariusz Kryński, but please e-mail us at firstname.lastname@example.org if you need support or advice. We’ll be glad to help!
Comments are closed.