Zenbu XML API

The Zenbu XML API allow third parties to access the content and features of the Zenbu website. There are no commercial boundaries on the API for up to 10,000 requests per day - above that and you have to work out a deal with us. Please respect our Creative Commons Attribution License.

You may also be interested in our REST API.

First you will need a Zenbu API Key. Log in and get it here.

Queries can be made to both of the different Zenbu searches - (the vanilla) Search and Find Nearest. Make a GET request using the urls and parameters specified below. All queries require you to specify your Zenbu API key.

Search

URL: http://www.zenbu.co.nz/search
Parameters:

• q: query
• pp: per page results to display (default 10, min 1, max 20)
• page: page number to display (default 1, will 404 if you enter an invalid or blank page)

Example
Find cafes in Wellington - 10 results returned

http://www.zenbu.co.nz/search.xml?q=wellington+cafe&key=YOURAPIKEY

Find Nearest

URL: http://www.zenbu.co.nz/findnearest
Parameters:

• q: query (nearest anything will display if left blank)
• l: nearest-to location
• x: longitude coordinate in WGS84
• y: latitude coordinate in WGS84
• pp: per page results to display (default 10, min 1, max 20)
• page: page number to display (default 1, will 404 if you enter an invalid or blank page)

If you specify all 3 of the x,y and l parameters, the x,y parameters take precedence.
Example
Find the 5 cafes nearest to the middle of Ghuznee St, Wellington

http://www.zenbu.co.nz/findnearest.xml?q=cafe&l=Ghuznee+St%2C+Wellington&pp=5&key=YOURAPIKEY

Maps

Please use the Google Maps API