Search Categories

http://api.eventfinda.sg/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.sg/v2/categories.xml?rows=1&levels=3&fields=category:(id,name,children)

Example Response

<?xml version="1.0"?>
<categories count="166">
 <category>
  <id>246</id>
  <name>All Events</name>
  <children count="6">
   <category>
    <id>3</id>
    <name><![CDATA[Business & Education]]></name>
    <children count="10">
     <category>
      <id>270</id>
      <name><![CDATA[Business & Professional]]></name>
     </category>
     <category>
      <id>275</id>
      <name>Classes</name>
     </category>
     <category>
      <id>54</id>
      <name>Conferences</name>
     </category>
     <category>
      <id>157</id>
      <name>Meetups</name>
     </category>
     <category>
      <id>289</id>
      <name>Multicultural</name>
     </category>
     <category>
      <id>207</id>
      <name>Public Meetings</name>
     </category>
     <category>
      <id>166</id>
      <name>Public Talks</name>
     </category>
     <category>
      <id>202</id>
      <name>Seminars</name>
     </category>
     <category>
      <id>269</id>
      <name>Technology</name>
     </category>
     <category>
      <id>267</id>
      <name>Workshops</name>
     </category>
    </children>
   </category>
   <category>
    <id>6</id>
    <name><![CDATA[Concerts & Gig Guide]]></name>
    <children count="38">
     <category>
      <id>249</id>
      <name>Acappella</name>
     </category>
     <category>
      <id>155</id>
      <name>Acoustic</name>
     </category>
     <category>
      <id>276</id>
      <name>Alternative</name>
     </category>
     <category>
      <id>147</id>
      <name>Blues</name>
     </category>
     <category>
      <id>310</id>
      <name>Cantopop</name>
     </category>
     <category>
      <id>250</id>
      <name>Christian</name>
     </category>
     <category>
      <id>279</id>
      <name>Classic Hits</name>
     </category>
     <category>
      <id>278</id>
      <name>Comedy</name>
     </category>
     <category>
      <id>154</id>
      <name>Country</name>
     </category>
     <category>
      <id>284</id>
      <name>Dance / DJ</name>
     </category>
     <category>
      <id>282</id>
      <name>Dubstep</name>
     </category>
     <category>
      <id>27</id>
      <name>EDM</name>
     </category>
     <category>
      <id>58</id>
      <name>Electronic</name>
     </category>
     <category>
      <id>281</id>
      <name>Emo</name>
     </category>
     <category>
      <id>290</id>
      <name>Experimental</name>
     </category>
     <category>
      <id>255</id>
      <name>Folk</name>
     </category>
     <category>
      <id>286</id>
      <name>Funk / Psychedelic</name>
     </category>
     <category>
      <id>252</id>
      <name>Gospel</name>
     </category>
     <category>
      <id>106</id>
      <name>Hip Hop / Rap</name>
     </category>
     <category>
      <id>146</id>
      <name>Indie</name>
     </category>
     <category>
      <id>283</id>
      <name>Industrial / Gothic</name>
     </category>
     <category>
      <id>285</id>
      <name>Jam Bands / Open Mic</name>
     </category>
     <category>
      <id>145</id>
      <name>Jazz</name>
     </category>
     <category>
      <id>308</id>
      <name>K-Pop</name>
     </category>
     <category>
      <id>29</id>
      <name>Karaoke</name>
     </category>
     <category>
      <id>248</id>
      <name>Latin</name>
     </category>
     <category>
      <id>307</id>
      <name>Mandopop</name>
     </category>
     <category>
      <id>148</id>
      <name>Metal</name>
     </category>
     <category>
      <id>28</id>
      <name>Music Festivals</name>
     </category>
     <category>
      <id>277</id>
      <name>New Age</name>
     </category>
     <category>
      <id>150</id>
      <name>Pop</name>
     </category>
     <category>
      <id>156</id>
      <name>Punk</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>315</id>
      <name>Ska</name>
     </category>
     <category>
      <id>266</id>
      <name>Variety Concerts</name>
     </category>
     <category>
      <id>149</id>
      <name>World Music</name>
     </category>
    </children>
   </category>
   <category>
    <id>11</id>
    <name>Exhibitions</name>
    <children count="8">
     <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>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="19">
     <category>
      <id>89</id>
      <name>Alumni, Associations, Clubs</name>
     </category>
     <category>
      <id>319</id>
      <name>Auctioning</name>
     </category>
     <category>
      <id>93</id>
      <name>Charity / Fundraisers</name>
     </category>
     <category>
      <id>5</id>
      <name>Children / Kids</name>
     </category>
     <category>
      <id>309</id>
      <name>Chinese New Year</name>
     </category>
     <category>
      <id>292</id>
      <name>Circus</name>
     </category>
     <category>
      <id>293</id>
      <name>Commemorations / Ceremonies</name>
     </category>
     <category>
      <id>288</id>
      <name>Ethnic / Multicultural</name>
     </category>
     <category>
      <id>192</id>
      <name>Expos / Conventions</name>
     </category>
     <category>
      <id>52</id>
      <name>Family Entertainment</name>
     </category>
     <category>
      <id>30</id>
      <name>Festivals</name>
     </category>
     <category>
      <id>321</id>
      <name>Film</name>
     </category>
     <category>
      <id>31</id>
      <name>Food / Wine</name>
     </category>
     <category>
      <id>49</id>
      <name>Games, Hobbies</name>
     </category>
     <category>
      <id>191</id>
      <name>Holidays</name>
     </category>
     <category>
      <id>84</id>
      <name><![CDATA[Home & Garden]]></name>
     </category>
     <category>
      <id>194</id>
      <name>Markets</name>
     </category>
     <category>
      <id>73</id>
      <name>New Years Eve</name>
     </category>
     <category>
      <id>212</id>
      <name>Singles</name>
     </category>
    </children>
   </category>
   <category>
    <id>1</id>
    <name>Performing Arts</name>
    <children count="14">
     <category>
      <id>22</id>
      <name>Ballet</name>
     </category>
     <category>
      <id>253</id>
      <name>Cabaret / Burlesque</name>
     </category>
     <category>
      <id>251</id>
      <name>Choir</name>
     </category>
     <category>
      <id>57</id>
      <name>Classical Music</name>
     </category>
     <category>
      <id>60</id>
      <name>Dance</name>
     </category>
     <category>
      <id>291</id>
      <name>Ethnic</name>
     </category>
     <category>
      <id>56</id>
      <name>Fashion</name>
     </category>
     <category>
      <id>25</id>
      <name>Film</name>
     </category>
     <category>
      <id>317</id>
      <name>Illusionists</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>211</id>
      <name>Orchestra</name>
     </category>
     <category>
      <id>21</id>
      <name>Theater</name>
     </category>
    </children>
   </category>
   <category>
    <id>7</id>
    <name>Sports</name>
    <children count="70">
     <category>
      <id>203</id>
      <name>Archery</name>
     </category>
     <category>
      <id>10</id>
      <name>Athletics</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>320</id>
      <name>Canoeing</name>
     </category>
     <category>
      <id>261</id>
      <name>Cheerleading</name>
     </category>
     <category>
      <id>305</id>
      <name>Chess</name>
     </category>
     <category>
      <id>98</id>
      <name>Cricket</name>
     </category>
     <category>
      <id>272</id>
      <name>Croquet</name>
     </category>
     <category>
      <id>45</id>
      <name>Cycling</name>
     </category>
     <category>
      <id>297</id>
      <name>Dance Sport</name>
     </category>
     <category>
      <id>316</id>
      <name>Darts</name>
     </category>
     <category>
      <id>301</id>
      <name>Diving</name>
     </category>
     <category>
      <id>311</id>
      <name>Dragonboat</name>
     </category>
     <category>
      <id>139</id>
      <name>Equestrian</name>
     </category>
     <category>
      <id>34</id>
      <name>Extreme</name>
     </category>
     <category>
      <id>113</id>
      <name>Fishing Tournaments</name>
     </category>
     <category>
      <id>97</id>
      <name>Fitness</name>
     </category>
     <category>
      <id>44</id>
      <name>Football</name>
     </category>
     <category>
      <id>298</id>
      <name><![CDATA[Fun Runs & Walks]]></name>
     </category>
     <category>
      <id>312</id>
      <name>Futsal</name>
     </category>
     <category>
      <id>205</id>
      <name>Games, Carnivals</name>
     </category>
     <category>
      <id>15</id>
      <name>Golf</name>
     </category>
     <category>
      <id>182</id>
      <name>Gymnastics</name>
     </category>
     <category>
      <id>306</id>
      <name>Handball</name>
     </category>
     <category>
      <id>95</id>
      <name>Hockey</name>
     </category>
     <category>
      <id>160</id>
      <name>Horse Racing</name>
     </category>
     <category>
      <id>123</id>
      <name>Indoor Bowls</name>
     </category>
     <category>
      <id>111</id>
      <name>Kayaking</name>
     </category>
     <category>
      <id>304</id>
      <name>Lacrosse</name>
     </category>
     <category>
      <id>120</id>
      <name>Lawn Bowls</name>
     </category>
     <category>
      <id>87</id>
      <name>Marathon</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>313</id>
      <name>Pool</name>
     </category>
     <category>
      <id>303</id>
      <name>Rodeo</name>
     </category>
     <category>
      <id>302</id>
      <name>Roller Derby</name>
     </category>
     <category>
      <id>116</id>
      <name>Rowing</name>
     </category>
     <category>
      <id>38</id>
      <name>Rugby</name>
     </category>
     <category>
      <id>14</id>
      <name>Sailing</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>40</id>
      <name>Soccer</name>
     </category>
     <category>
      <id>294</id>
      <name>Softball</name>
     </category>
     <category>
      <id>122</id>
      <name>Squash</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>314</id>
      <name>Telematch</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>
     <category>
      <id>61</id>
      <name>Yoga</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.