If you're looking to create an app for a mobile phone (or some kind of web service, or whatever else your heart desires) that uses Barnivore data, you're in luck! We have an API available.
Please note that we're in the process of updating a few things, and some of the feeds below may change. If you're using any of the calls for live lookups as opposed to an occasional data dump tool, please get in touch!
Here's the FAQ before we get into the details:
- The API is free to use, subject to a few simple terms that just make sure the data doesn't confuse people.
- We'll try not to break the API, but we don't guarantee service levels.
- You can make money off of your creation.
- Let us know if you do make anything so we can promote it (and get a sense of who's doing what.)
- The API is the dumbest thing ever, so feel free to offer suggestions.
Here's some basic info about our Barnivore data feeds that you can use to form the basis for your app:
First of all, information is available for beer, wine, and liquor through one of these (you can get it in XML format by changing the extension):
To retrieve information on individual products:
http://barnivore.com/company/559.json (or any other ID, obviously)
Finally, for search:
Please use the feed URLs for batch jobs and not recurring calls, due to the volume of data they move, but that's basically where we're at! At the moment, most people are crawling the feed/info results and caching the data locally on the device or their servers, but if you're feeling ambitious about real time data, let's talk about the best way to structure that - it's not so much about our servers as it is the mobile web's speed and cost constraints.
We may add fields or other calls, but we'll do our best not to make any breaking changes to these API calls. If there are other calls that would be helpful to you, please don't hesitate to ask.
And to be clear, while we want some credit, that shouldn't extend to your app's name. In other words, don't use the term Barnivore or some clever derivation, because people will think we wrote it, and we're not your tech support department. Please ensure that your users know that you're using Barnivore data, but you're not Barnivore.
Thanks, and have fun!