Search Categories

http://api.eventfinda.co.nz/v2/categories.xml

Searches the database and returns categories and venues matching the given criteria.

Categories are in a tree structure which you can explore on the Find Events page.

Example Request

http://api.eventfinda.co.nz/v2/categories.xml?rows=1&levels=3&fields=category:(id,name,children)

Example Response

<?xml version="1.0"?>
<categories count="149">
 <category>
  <id>246</id>
  <name>All Events</name>
  <children count="6">
   <category>
    <id>6</id>
    <name><![CDATA[Concerts & Gig Guide]]></name>
    <children count="27">
     <category>
      <id>146</id>
      <name>Alternative, Indie</name>
     </category>
     <category>
      <id>284</id>
      <name>Bar DJs</name>
     </category>
     <category>
      <id>145</id>
      <name>Blues</name>
     </category>
     <category>
      <id>279</id>
      <name>Classic Rock</name>
     </category>
     <category>
      <id>154</id>
      <name>Country</name>
     </category>
     <category>
      <id>276</id>
      <name>Covers, Tribute Bands</name>
     </category>
     <category>
      <id>109</id>
      <name>DJs, Clubbing</name>
     </category>
     <category>
      <id>277</id>
      <name>Dub, Roots</name>
     </category>
     <category>
      <id>290</id>
      <name>Electronica</name>
     </category>
     <category>
      <id>255</id>
      <name>Folk</name>
     </category>
     <category>
      <id>286</id>
      <name>Funk</name>
     </category>
     <category>
      <id>106</id>
      <name>Hip Hop, Rap</name>
     </category>
     <category>
      <id>147</id>
      <name>Jazz</name>
     </category>
     <category>
      <id>248</id>
      <name>Latin</name>
     </category>
     <category>
      <id>148</id>
      <name>Metal</name>
     </category>
     <category>
      <id>28</id>
      <name>Music Festivals</name>
     </category>
     <category>
      <id>285</id>
      <name>Open Mic, Jams</name>
     </category>
     <category>
      <id>150</id>
      <name>Pop</name>
     </category>
     <category>
      <id>156</id>
      <name>Punk</name>
     </category>
     <category>
      <id>29</id>
      <name>Quiz, Karaoke</name>
     </category>
     <category>
      <id>151</id>
      <name><![CDATA[R&B, Soul]]></name>
     </category>
     <category>
      <id>153</id>
      <name>Reggae</name>
     </category>
     <category>
      <id>152</id>
      <name>Rock</name>
     </category>
     <category>
      <id>302</id>
      <name>Singer-Songwriter</name>
     </category>
     <category>
      <id>265</id>
      <name>Swing, Big Bands</name>
     </category>
     <category>
      <id>266</id>
      <name>Variety Concerts</name>
     </category>
     <category>
      <id>149</id>
      <name>World</name>
     </category>
    </children>
   </category>
   <category>
    <id>11</id>
    <name>Exhibitions</name>
    <children count="9">
     <category>
      <id>262</id>
      <name>Contemporary Art</name>
     </category>
     <category>
      <id>273</id>
      <name><![CDATA[Craft & Object Art]]></name>
     </category>
     <category>
      <id>74</id>
      <name>Fine Art</name>
     </category>
     <category>
      <id>197</id>
      <name>Museums</name>
     </category>
     <category>
      <id>257</id>
      <name>Natural History</name>
     </category>
     <category>
      <id>259</id>
      <name>Pacific Cultures</name>
     </category>
     <category>
      <id>195</id>
      <name>Photography</name>
     </category>
     <category>
      <id>256</id>
      <name>Sculpture</name>
     </category>
     <category>
      <id>274</id>
      <name><![CDATA[Social & Political History]]></name>
     </category>
    </children>
   </category>
   <category>
    <id>190</id>
    <name><![CDATA[Festivals & Lifestyle]]></name>
    <children count="15">
     <category>
      <id>73</id>
      <name><![CDATA[A&P Shows, Field Days]]></name>
     </category>
     <category>
      <id>89</id>
      <name>Alumni, Associations, Clubs</name>
     </category>
     <category>
      <id>93</id>
      <name>Charity, Fundraisers</name>
     </category>
     <category>
      <id>5</id>
      <name>Children, Kids, Holidays</name>
     </category>
     <category>
      <id>293</id>
      <name>Commemorations, Ceremonies</name>
     </category>
     <category>
      <id>292</id>
      <name>Conservation, Environment</name>
     </category>
     <category>
      <id>288</id>
      <name>Ethnic, Multicultural</name>
     </category>
     <category>
      <id>52</id>
      <name>Family Entertainment</name>
     </category>
     <category>
      <id>30</id>
      <name>Festivals</name>
     </category>
     <category>
      <id>313</id>
      <name>Film</name>
     </category>
     <category>
      <id>31</id>
      <name>Food, Gourmet, Wine</name>
     </category>
     <category>
      <id>49</id>
      <name>Games, Hobbies</name>
     </category>
     <category>
      <id>192</id>
      <name>Lifestyle Shows, Expos</name>
     </category>
     <category>
      <id>194</id>
      <name>Markets and Fairs</name>
     </category>
     <category>
      <id>212</id>
      <name>Socials, Singles, Balls</name>
     </category>
    </children>
   </category>
   <category>
    <id>1</id>
    <name>Performing Arts</name>
    <children count="14">
     <category>
      <id>60</id>
      <name>Ballet</name>
     </category>
     <category>
      <id>253</id>
      <name>Cabaret, Burlesque</name>
     </category>
     <category>
      <id>251</id>
      <name>Choir, Vocal Music</name>
     </category>
     <category>
      <id>312</id>
      <name>Circus</name>
     </category>
     <category>
      <id>57</id>
      <name>Classical Music</name>
     </category>
     <category>
      <id>48</id>
      <name>Comedy</name>
     </category>
     <category>
      <id>22</id>
      <name>Dance</name>
     </category>
     <category>
      <id>291</id>
      <name>Ethnic, Multicultural</name>
     </category>
     <category>
      <id>56</id>
      <name>Fashion</name>
     </category>
     <category>
      <id>25</id>
      <name>Film</name>
     </category>
     <category>
      <id>26</id>
      <name>Literary</name>
     </category>
     <category>
      <id>23</id>
      <name>Musicals</name>
     </category>
     <category>
      <id>59</id>
      <name>Opera</name>
     </category>
     <category>
      <id>21</id>
      <name>Theatre</name>
     </category>
    </children>
   </category>
   <category>
    <id>7</id>
    <name><![CDATA[Sports & Outdoors]]></name>
    <children count="70">
     <category>
      <id>34</id>
      <name>Adventure, Extreme</name>
     </category>
     <category>
      <id>203</id>
      <name>Archery</name>
     </category>
     <category>
      <id>10</id>
      <name>Athletics</name>
     </category>
     <category>
      <id>304</id>
      <name>Australian Football</name>
     </category>
     <category>
      <id>68</id>
      <name>Aviation</name>
     </category>
     <category>
      <id>16</id>
      <name>Badminton</name>
     </category>
     <category>
      <id>41</id>
      <name>Baseball</name>
     </category>
     <category>
      <id>43</id>
      <name>Basketball</name>
     </category>
     <category>
      <id>110</id>
      <name>Boating</name>
     </category>
     <category>
      <id>159</id>
      <name>Boxing</name>
     </category>
     <category>
      <id>261</id>
      <name>Cheerleading, Marching</name>
     </category>
     <category>
      <id>131</id>
      <name>Climbing</name>
     </category>
     <category>
      <id>98</id>
      <name>Cricket</name>
     </category>
     <category>
      <id>272</id>
      <name>Croquet, Golf Croquet</name>
     </category>
     <category>
      <id>45</id>
      <name>Cycling</name>
     </category>
     <category>
      <id>297</id>
      <name>Dance Sport</name>
     </category>
     <category>
      <id>308</id>
      <name>Darts</name>
     </category>
     <category>
      <id>301</id>
      <name>Diving</name>
     </category>
     <category>
      <id>139</id>
      <name>Equestrian</name>
     </category>
     <category>
      <id>305</id>
      <name>Fencing</name>
     </category>
     <category>
      <id>113</id>
      <name>Fishing Tournaments</name>
     </category>
     <category>
      <id>315</id>
      <name>Fitness </name>
     </category>
     <category>
      <id>298</id>
      <name><![CDATA[Fun Runs & Walks]]></name>
     </category>
     <category>
      <id>205</id>
      <name>Games, Carnivals</name>
     </category>
     <category>
      <id>314</id>
      <name>Gardens</name>
     </category>
     <category>
      <id>15</id>
      <name>Golf, Disc Golf</name>
     </category>
     <category>
      <id>182</id>
      <name>Gymnastics</name>
     </category>
     <category>
      <id>309</id>
      <name>Handball</name>
     </category>
     <category>
      <id>95</id>
      <name>Hockey</name>
     </category>
     <category>
      <id>160</id>
      <name>Horse Racing</name>
     </category>
     <category>
      <id>310</id>
      <name>Hunting</name>
     </category>
     <category>
      <id>303</id>
      <name>Ice Hockey</name>
     </category>
     <category>
      <id>123</id>
      <name>Indoor Bowls, Boccia</name>
     </category>
     <category>
      <id>111</id>
      <name>Kayaking, Canoeing, Waka Ama</name>
     </category>
     <category>
      <id>120</id>
      <name>Lawn Bowls, Petanque</name>
     </category>
     <category>
      <id>87</id>
      <name>Marathon, Running</name>
     </category>
     <category>
      <id>295</id>
      <name>Martial Arts</name>
     </category>
     <category>
      <id>46</id>
      <name>Motorsport</name>
     </category>
     <category>
      <id>33</id>
      <name>Mountain Biking</name>
     </category>
     <category>
      <id>112</id>
      <name>Multisport</name>
     </category>
     <category>
      <id>39</id>
      <name>Netball</name>
     </category>
     <category>
      <id>247</id>
      <name>Orienteering</name>
     </category>
     <category>
      <id>126</id>
      <name>Outdoors, Tramping</name>
     </category>
     <category>
      <id>287</id>
      <name>Poker</name>
     </category>
     <category>
      <id>116</id>
      <name>Rowing</name>
     </category>
     <category>
      <id>44</id>
      <name>Rugby League</name>
     </category>
     <category>
      <id>38</id>
      <name>Rugby Union</name>
     </category>
     <category>
      <id>264</id>
      <name>RWC Rugby World Cup 2011</name>
     </category>
     <category>
      <id>14</id>
      <name>Sailing</name>
     </category>
     <category>
      <id>311</id>
      <name>Shearing</name>
     </category>
     <category>
      <id>8</id>
      <name>Shooting</name>
     </category>
     <category>
      <id>263</id>
      <name>Skating</name>
     </category>
     <category>
      <id>17</id>
      <name>Ski, Snow, Winter Sports</name>
     </category>
     <category>
      <id>307</id>
      <name>Snooker, Billiards, Pool</name>
     </category>
     <category>
      <id>40</id>
      <name>Soccer</name>
     </category>
     <category>
      <id>294</id>
      <name>Softball</name>
     </category>
     <category>
      <id>122</id>
      <name>Squash</name>
     </category>
     <category>
      <id>306</id>
      <name>Stand Up Paddle Boarding</name>
     </category>
     <category>
      <id>115</id>
      <name>Surfing</name>
     </category>
     <category>
      <id>35</id>
      <name>Swimming</name>
     </category>
     <category>
      <id>124</id>
      <name>Table Tennis</name>
     </category>
     <category>
      <id>296</id>
      <name>Ten Pin Bowling</name>
     </category>
     <category>
      <id>121</id>
      <name>Tennis</name>
     </category>
     <category>
      <id>299</id>
      <name>Touch Rugby</name>
     </category>
     <category>
      <id>300</id>
      <name><![CDATA[Track & Field]]></name>
     </category>
     <category>
      <id>100</id>
      <name>Triathlon</name>
     </category>
     <category>
      <id>137</id>
      <name>Volleyball</name>
     </category>
     <category>
      <id>118</id>
      <name>Waterskiing</name>
     </category>
     <category>
      <id>117</id>
      <name><![CDATA[Wind & Kite Surfing]]></name>
     </category>
     <category>
      <id>13</id>
      <name>Wrestling</name>
     </category>
    </children>
   </category>
   <category>
    <id>3</id>
    <name><![CDATA[Workshops, Conferences & Classes]]></name>
    <children count="7">
     <category>
      <id>270</id>
      <name><![CDATA[Business & Professional]]></name>
     </category>
     <category>
      <id>275</id>
      <name>Dance Classes</name>
     </category>
     <category>
      <id>163</id>
      <name>Education</name>
     </category>
     <category>
      <id>289</id>
      <name>Ethnic, Multicultural</name>
     </category>
     <category>
      <id>140</id>
      <name><![CDATA[Family & Lifestyle]]></name>
     </category>
     <category>
      <id>268</id>
      <name><![CDATA[Mind & Body]]></name>
     </category>
     <category>
      <id>166</id>
      <name><![CDATA[Public Talks & Tours]]></name>
     </category>
    </children>
   </category>
  </children>
 </category>
</categories>

Parameters

The following parameters are available along with the common parameters.

category

Only return results which are a descendent of this category id.

Specify multiple IDs by separating them with a comma (,).

category_slug

Only return results where are a descendent of the category specified by this URL slug

Specify multiple URL slugs by separating them with a comma (,).

levels

An integer specifying the number of child levels to include in the children element of the returned results. For example specifying 1 (which is the default) would include only the matching categories without a children element. Specifying levels=2 would include the matching results and their immediate children. Specifying levels=3 would include the matching results, their immediate children and their immediate children's children, i.e. three generations.

A side effect of specifying levels greater than 1 is that the first level will also have a parents element. The parents element includes a collection of category elements which are ancestors of the category with the most immediate ancestors first.

order

Specify the order the results should be in. Possible values are

  • name

If nothing is specified they are sorted by Eventfinda's default order.