The Advanced Programming Interface (API) is experimental, but I welcome you to take a shot at breaking it (not too hard please) and let me know what could work better. Use the details on the contact page to get in touch.

How it works

The API supports GET requests for annual fishery landings data at the following url:

http://openfisheries.org/api/landings

and produces a valid JSON document for global fisheries landings. There are parsers for nearly every programming language for reading JSON documents including for the R-project and Python.

API parameters

In addition to global aggregate landings, one can download landings by country or species with the following two urls.

http://openfisheries.org/api/landings/countries

http://openfisheries.org/api/landings/species

These URLs will return a complete list of all countries and species, respectively, that can be used in API calls. For example, to get an aggregate list of landings by Canada, one would use the url:

http://openfisheries.org/api/landings/countries/CAN

Where the final parameter ('CAN') is the ISO-3166 alpha 3 country code. Similarly, one can download all landings for skipjack tuna using the following url:

http://openfisheries.org/api/landings/species/SKJ

Where the last parameter in the url ('SKJ') is the three-letter ASFIS species code
Additional API work will allow downloads by FAO statistical area, marine/inland species designation and the ability to download by multiple parameters, ie. download all skipjack tuna landings by Japan in the year 2000. Until then, feel free to contact me for more info about the API.