Phish.Net features a Javascript/HTTP based API. The API is located at http://api.phish.net/api.js.
You can request the api with any file extension you'd like. This is provided for maximum compatibility. For example, you can make requests for "api.json" or "api.php".
All variables sent to the API should be sent via GET parameters. POST data is accepted as well (GET will win in a conflict).
Public APIs: The following APIs are available at all times with no rate limit.
- getLatestLinked
- getLatestSetlist
- getRandomShow
- getRecentComments
- getRecentNews
- getRecentReviews
- getRecentSetlists
- getTIPH
Protected APIs: The following APIs are available with an API Key.
If no method is specified, it will return getRecentNews.
Hosted Callback Functions: The following javascript callback functions are hosted on Phish.Net for your use and can be found at http://api.phish.net/callbacks/.
- pnet3-news.js: a basic news display function
- pnet3-setlist.js: a basic setlist display function
- pnet3-review.js: a basic review display function
- pnet3-comment.js: a basic comment display function
Examples:: The below HTML source file demonstrates the use of four API methods and associated callbacks. The callback functions are very basic, but you can modify them and self host them to fit the look-and-feel of your site. API methods will not change; although new versions may at some point be released, as long as you pass the current API version, these scripts will continue to output data in the same format.
- api-demo.html.txt shows example API and callback usage.