Monday, February 06, 2012

API Usage Guidelines

7digital monitors all API requests and we reserve the right to revoke your API key without notice if you do not follow the guidelines outlined below, full Terms and Conditions for non-commercial use of the API are available on this site. 

Separate Terms and Conditions for the commercial use of the API are available on request, contact the 7digital sales team for details.
  1. Usage limits. The 7digital API for non-commercial use is rate limited to 4000 requests per day. 
  2. Commercial Use.The API is available for free to non-commercial users. If you would like to use the API in a commercial application or if you're unsure whether you qualify as a non-commercial user please contact us first.
  3. Cache Use. If your website or application needs to repeatedly access the same data please cache the 7digital API responses either directly in your code or by setting up a cached proxy to the API.
  4. Do not scrape the API.  The 7digital API is designed for real-time use by human end users. Please don't attempt to scrape the content in an automated way using scripts (e.g. getting release details for release id 1, 2, 3, 4, etc.) as this might negatively affect the performance for other users and will get you banned. If you need to process the catalogue data off-line please contact us and we can provide you with FTP access to an XML dump of the whole 7digital catalogue (premium service).
  5. Don't do anything illegal.  Using the 7digital API in connection with any illegal services is strictly prohibited.
  6. Link to 7digital. Please let your users know the data is provided by 7digital. Download the 7digital press kit which includes a couple of versions of our logo and guidelines for its use.
  7. Let us know about your application. We like to see what people can do with our API. This gives us valuable feedback and can influence how we shape our API in the future. By giving us a chance to review your integration we can also provide feedback to you if we should see any legal or technical issues with it. And we might be able to showcase your app to our users and clients. You can let everyone know by posting a URL to http://groups.google.com/group/7digital-api or contact us directly.
  8. It's nice to share. If you've implemented a 7digital API wrapper in your favourite language or have other pieces of code that you think others might find useful, the community will be grateful if you share it with us. You can post your achievements to our google group (http://groups.google.com/group/7digital-api) or let us know directly and we can publish it on the 7digital Developers site.
  9. Take a look a the Best Practices Guide. The guide has pointers on how to build applications with the API and to cater for changes in the API.